실전 사용법

설치한 뒤,
이 순서대로 시작하세요

코딩을 몰라도 전략 파일 작성부터 거래소 연결, 모의투자, 안전 점검, 보고서 확인까지 순서대로 따라할 수 있습니다.

이 페이지는 제품 사용 설명이며 투자 조언이 아닙니다.

  1. 1전략 규칙 적기
  2. 2거래소 연결하기
  3. 3모의투자로 확인하기
  4. 4안전 상태 점검하기
  5. 5결과와 보고서 읽기

01 · 전략 파일 작성

메모 한 줄이면
충분합니다

복잡한 JSON을 직접 작성할 필요가 없습니다. 메모장에 규칙을 한 줄씩 적어 텍스트 파일(.txt)이나 마크다운 파일(.md)로 저장한 뒤 앱의 “전략 만들기”에서 불러오세요. PTE가 사람이 읽기 쉬운 전략 초안으로 정리하며, 사용자가 승인하기 전에는 실행하지 않습니다.

사용할 수 있는 파일 형식

텍스트 파일(.txt)

일반 메모장으로 만들 수 있는 가장 단순한 문서입니다.

마크다운 파일(.md)

제목과 목록 같은 간단한 형식을 사용할 수 있는 텍스트 문서입니다.

JSON 파일(.json)

구조화된 설정 파일이며 초보자가 직접 작성할 필요는 없습니다.

지원하는 표현

아래 문장은 사용법을 보여주는 예시이며 투자 추천이 아닙니다.

매수 조건

가격이 200일 이동평균선을 위로 돌파하면 매수 후보로 표시합니다.

매수: PRICE cross_above MA(200)

매도 조건

가격이 200일 이동평균선을 아래로 내려가면 매도 후보로 표시합니다.

매도: PRICE cross_below MA(200)

손실 제한

가격이 매수가보다 5% 내려가면 손실을 제한하는 규칙을 적용합니다.

손절: 5%

수익 목표

가격이 매수가보다 10% 올라가면 이익을 확정하는 규칙을 적용합니다.

익절: 10%

한 번에 사용할 최대 금액

한 번의 거래에 사용할 수 있는 금액을 100,000원으로 제한합니다.

거래당 최대 노출: 100000

재실행 대기 시간

한 번 실행한 뒤 같은 조건을 다시 확인하기까지 3,600초, 즉 1시간 기다립니다.

쿨다운: 3600초

동시 보유 한도

동시에 들고 있을 포지션 수를 1개로 제한합니다.

최대 보유 수: 1

거래 금지

정해진 조건에서는 위 규칙과 상관없이 어떤 거래도 만들지 않습니다.

거래 금지

문장이 애매하거나 지원하지 않는 표현이면 추측하지 않고 확인 질문을 띄웁니다. 질문이 하나라도 남아 있으면 전략 파일은 만들어지지 않습니다.

바로 써보는 템플릿

아래 두 가지는 그대로 붙여 넣어도 확인 질문 없이 전략 파일이 만들어지는 예시입니다. 숫자만 자신의 기준으로 바꾸세요. 여러 가격대에 동시에 주문을 까는 전통적 의미의 그리드 봇은 아직 지원하지 않습니다 — 지원하지 않는 걸 지원한다고 하지 않습니다.

추세추종형 · 이동평균 교차

가격이 200일 이동평균선을 위로 돌파하면 사고, 아래로 돌파하면 파는 기본형입니다.

매수: PRICE cross_above MA(200)
매도: PRICE cross_below MA(200)
손절: 5%
익절: 10%
거래당 최대 노출: 100000
쿨다운: 3600초

역추세형 · RSI 과매도·과매수

RSI가 낮으면(과매도) 사고 높으면(과매수) 파는 형태입니다. 급락 직후 진입을 한 번으로 제한합니다.

매수: RSI(14) < 30
매도: RSI(14) > 70
손절: 4%
익절: 8%
거래당 최대 노출: 100000
쿨다운: 3600초
최대 보유 수: 1

02 · 거래소 연결

거래소 연결은
필요한 권한만 사용하세요

모의투자와 시세 확인만 사용하는 경우에는 읽기 권한만 허용하세요. 실거래를 사용하는 경우에도 거래에 필요한 최소 권한만 허용하고, 필요하지 않은 출금 권한은 켜지 마세요. 연결 정보는 이 PC의 Windows 보안 저장소에 보관됩니다.

읽기 권한

시세와 계정 상태를 확인할 수 있지만 주문이나 출금은 할 수 없습니다.

거래 권한

주문 제출과 취소가 가능한 강한 권한입니다. 실거래에 필요한 경우에만 사용하세요.

출금 권한

자산을 거래소 밖으로 보낼 수 있는 매우 강한 권한입니다. 별도로 관리하고 처음에는 소액으로 확인하세요.

저장 후 “연결 확인”을 누르면 잔고 조회 등 읽기 전용 요청 하나로 연결 상태만 확인합니다. 필요 없어지면 “삭제”로 즉시 로컬에서 제거할 수 있습니다.

03 · 모의투자와 비교 실행

두 방식 모두 실제 주문은
보내지 않습니다. 확인하는 내용이 다릅니다.

모의투자

모의투자

가상 자금으로 주문 체결과 손익을 계산합니다. 실제 돈이나 실제 주문은 사용하지 않습니다.

  • 가상 잔고·가상 시세로만 동작
  • 업비트 API 키가 없어도 실행 가능
  • 승인된 전략 파일만 있으면 바로 확인 가능
비교 실행

비교 실행

실시간 시세를 보면서 주문 조건이 승인될 상황인지 기록합니다. 실제 주문을 보내지 않으며 가상 체결이나 손익도 계산하지 않습니다.

  • 실제 시세·잔고를 읽어와 판단은 하되 주문은 내지 않음
  • API 키 저장과 연결 확인이 먼저 필요
  • 실거래 전 마지막 점검 단계

두 방식 모두 승인된 전략이 선택되어 있어야 실행할 수 있습니다. 그 전까지는 항상 잠겨 있습니다.

04 · 승인과 안전 점검

확실하지 않으면 멈추고
먼저 확인합니다

기준 데이터 확인 필요

안전한 실행에 필요한 기준 데이터를 확인하지 못했습니다.

데이터를 복구하거나 다시 확인한 뒤 안전 점검을 실행하세요.

복구가 필요해 잠겨 있음

기록과 거래소의 실제 상태가 달라 자동으로 진행하지 않고 멈췄습니다.

차이를 직접 확인하고 어느 쪽이 맞는지 선택한 뒤 다시 시도하세요.

실거래 전 안전 점검 필요

실거래를 시작하기 전 필요한 점검이 아직 끝나지 않았습니다.

실행 센터에서 안전 점검을 먼저 실행하세요.

  • 앱을 껐다 켰을 때항상 잠긴 상태에서 시작하며, 로컬 기록과 거래소 상태를 먼저 비교합니다.
  • 기록과 실제 상태가 다를 때자동으로 어느 한쪽에 맞추지 않고 사용자의 확인을 기다립니다.
  • 전략 파일을 바꿨을 때파일 내용이 달라지면 승인이 무효화되어 다시 검토·승인해야 합니다.
  • 원인을 모를 때봇닥터로 프로젝트 설정과 기록 파일을 점검해 문제 가능성을 등급별로 보여줍니다.

제거는 설치 제거 프로그램으로 하며, 사용자 프로젝트와 기록은 기본적으로 보존됩니다. 완전히 지우려면 데이터 삭제 옵션을 함께 선택하세요.

새 버전이 나왔는지는 자동으로 확인하지 않습니다. 제품 정보 화면의 “지금 확인” 버튼을 눌렀을 때만 확인 요청을 보냅니다.

05 · 전략 도우미

무엇을 적을지 막막하면
도우미가 질문으로 정리해 줍니다

도우미는 투자 결정을 대신하지 않습니다. 매수 조건, 매도 조건, 손실 제한, 사용할 금액처럼 빠진 정보를 차례로 물어보고 사용자의 답을 전략 초안으로 정리합니다.

  • 언제 매수 후보로 볼까요?프로젝트 화면에서 손실 감내 수준, 청산 기준, 거래 금지 조건 등 5개의 짧은 질문에 답하면 투자 철학·진입청산 기준·금지 행동으로 자동 정리됩니다. 저장은 항상 별도 버튼을 눌러야 반영됩니다.
  • 한 번에 얼마까지, 손실은 어디까지 허용할까요?투자 철학·진입청산·금지행동·인사이트 입력란마다 “예시 보기” 버튼으로 생각을 시작할 문장을 볼 수 있습니다. 정답이나 추천이 아니며, 저작권이 있는 실명 인용은 담지 않습니다.
  • 떠오른 생각을 어디에 남길까요?유명 투자자의 철학, 다른 사람의 조언, 떠오른 생각을 인사이트 화면에 분류 없이 자유롭게 모아 둘 수 있습니다. “프로젝트에 복사” 버튼으로 투자 철학이나 금지 행동 필드에 옮겨 담을 수 있고, 삭제해도 30일간 복원할 수 있습니다.

도우미의 답변은 전략이나 자동매매 규칙에 자동 반영되지 않으며, API 키·비밀번호 등은 저장하지 않아야 합니다.

06 · 모의투자 결과

모의투자를 실행한 뒤
무엇을 확인할 수 있나요?

진행 상황

모의투자가 시작되었는지, 실행 중인지, 종료되었는지 확인합니다.

손익 요약

가상 주문의 이익과 손실, 수수료와 최대 손실 구간을 확인합니다.

성과 분석

어떤 조건이 결과에 도움이 되었고 어떤 조건을 다시 확인해야 하는지 살펴봅니다.

메신저 보고

선택한 결과를 텔레그램이나 라인으로 받을 수 있습니다. 연결을 완료한 경우에만 전송됩니다.

  • 실행 전 점검투자 철학·진입청산·금지행동 중 비어 있는 항목과 즐겨찾기한 인사이트 하나를 조용히 보여줍니다. 비차단 안내이며, 그대로 진행할지는 항상 사용자가 선택합니다.
  • 결정 이유 설명참조 대시보드의 결정 기록은 “설정한 손절 조건이 충족되어 포지션이 정리되었습니다” 같은 문장으로, 어떤 사용자 규칙이 실행에 영향을 줬는지 설명합니다.

막혔을 때

막혔을 때는
여기부터 확인하세요

버튼이 회색으로 비활성화되어 있음

누르려는 버튼이 회색으로 보이고 반응하지 않습니다.

가장 흔한 원인필수 확인이나 연결이 아직 끝나지 않았거나, 체험용(데모) 프로젝트라 실제 동작을 막아 두었을 수 있습니다.

먼저 할 일버튼 가까이에 표시된 안내 문구나 마우스를 올렸을 때 나오는 도움말을 먼저 확인하세요.

데모 프로젝트는 실제 전송·저장 버튼을 코드에서 명시적으로 비활성화합니다.

전략 파일을 불러오지 못함

파일을 불러와도 규칙 후보가 만들어지지 않거나 확인 질문만 계속 뜹니다.

가장 흔한 원인문장이 모호하거나 아직 지원하지 않는 표현이 포함되어 있을 수 있습니다.

먼저 할 일지원하는 표현 목록과 비교해 문장을 다시 정리하고, 뜨는 확인 질문에 하나씩 답하세요.

확인 질문이 하나라도 남아 있으면 strategy_config.json은 만들어지지 않습니다.

거래소 연결 확인이 실패함

“연결 확인”을 눌러도 실패 메시지가 나옵니다.

가장 흔한 원인거래소에서 키가 아직 활성화되지 않았거나, 필요한 권한이 꺼져 있거나, IP 제한에 걸렸을 수 있습니다.

먼저 할 일거래소 웹사이트에서 키 상태와 권한을 다시 확인한 뒤 저장하고 다시 시도하세요.

연결 확인은 잔고 조회 같은 읽기 전용 요청 한 건으로만 이루어집니다.

모의투자를 시작할 수 없음

실행 버튼을 눌러도 모의투자가 시작되지 않습니다.

가장 흔한 원인승인된 전략이 선택되지 않았거나, 시작 전 점검에서 비어 있는 항목이 남아 있을 수 있습니다.

먼저 할 일전략이 승인되었는지, 점검 안내에 표시된 빈 항목을 채웠는지 확인하세요.

승인(APPROVED)된 strategy_config.json이 선택되어 있어야 실행할 수 있습니다.

안전 잠금이 표시됨

화면에 잠금 안내가 뜨고 실행 버튼이 막혀 있습니다.

가장 흔한 원인앱을 다시 시작했거나, 저장된 기록과 거래소의 실제 상태가 다르게 확인되었을 수 있습니다.

먼저 할 일화면에 안내된 대로 기준 데이터를 확인하거나 복구한 뒤 안전 점검을 다시 실행하세요.

앱은 항상 잠금 상태로 시작하며, 기록과 실제 상태가 다르면 자동으로 어느 한쪽에 맞추지 않습니다.

텔레그램 또는 라인 보고서가 오지 않음

메신저 연결은 마쳤는데 보고서 메시지가 오지 않습니다.

가장 흔한 원인받고 싶은 보고서 종류의 체크박스가 꺼져 있거나, 전송 목록에 추가만 하고 실제 전송 버튼을 누르지 않았을 수 있습니다.

먼저 할 일설정에서 원하는 보고서 종류가 켜져 있는지 확인하고, 전송 목록에서 보고를 선택해 전송 버튼까지 눌렀는지 확인하세요.

전송 목록 추가와 실제 전송은 서로 다른 별개의 동작입니다.

백업을 복구할 수 없음

복구 버튼을 눌러도 진행되지 않거나 오류가 표시됩니다.

가장 흔한 원인선택한 백업 파일이 손상되었거나 호환되지 않는 버전이거나, 기존 프로젝트와 이름이 겹칠 수 있습니다.

먼저 할 일“백업 내용 확인”으로 먼저 내용을 확인하고, 화면에 안내된 충돌 항목을 확인하세요.

복구는 항상 새 복사본을 만들며 기존 프로젝트를 덮어쓰지 않습니다.

영문판과 한국어판 문구가 섞여 보임

언어를 전환했는데 일부 화면에 이전 언어 문구가 남아 있습니다.

가장 흔한 원인언어를 전환한 뒤 앱을 다시 시작하지 않았을 수 있습니다.

먼저 할 일언어를 전환한 뒤에는 화면에 안내된 대로 앱을 다시 시작하세요.

언어 전환은 다시 시작한 뒤에만 모든 화면에 적용됩니다.

용어 사전

처음 보는 용어,
여기서 바로 확인하세요

영어 약어와 코인 용어를 몰라도 괜찮습니다. 화면에서 본 단어를 검색하거나 분류를 골라 펼치면 뜻과 공식 기술 이름을 바로 확인할 수 있습니다.

PTE

사용자가 정한 투자 원칙을 규칙으로 정리하고, 모의투자·검증·실행을 돕는 프로그램입니다.

전략

언제 사고, 언제 팔고, 얼마까지 위험을 허용할지 정한 규칙 묶음입니다.

매수

코인이나 자산을 사는 주문입니다.

매도

보유한 코인이나 자산을 파는 주문입니다.

이동평균선

일정 기간의 평균 가격을 이어 만든 선입니다. 200일 이동평균선은 최근 200일의 평균 흐름을 보여줍니다.

손실 제한

손실이 정한 수준에 닿으면 더 커지기 전에 거래를 종료하는 규칙입니다.

기술 이름 보기: 손절 / Stop-Loss

수익 목표

이익이 정한 수준에 닿으면 거래를 종료해 이익을 확정하는 규칙입니다.

기술 이름 보기: 익절 / Profit Target

모의투자

가상 자금으로 주문과 손익을 계산하는 연습 방식입니다. 실제 돈은 움직이지 않습니다.

기술 이름 보기: Simulation / PAPER

비교 실행

실시간 시세를 보면서 주문 조건이 승인될 상황인지 확인하는 방식입니다. 실제 주문과 가상 체결은 만들지 않습니다.

기술 이름 보기: Comparison Run / SHADOW

실거래

실제 자금으로 거래소에 주문을 제출하는 방식입니다. 손실이 발생할 수 있습니다.

기술 이름 보기: Live Trading / LIVE

주문 체결

매수 또는 매도 주문이 거래소에서 실제로 성립한 상태입니다.

수수료

거래소가 주문 처리에 대해 부과하는 비용입니다.

주문 가격 차이

예상한 주문 가격과 실제 체결 가격 사이의 차이입니다.

기술 이름 보기: Slippage

API

PTE와 거래소가 정보를 주고받을 수 있게 연결하는 통로입니다.

거래소 연결 정보

PTE가 사용자의 거래소 계정에 허용된 기능을 사용하기 위해 필요한 비밀 연결값입니다.

읽기 권한

시세와 계정 정보를 확인할 수 있지만 주문이나 출금은 할 수 없는 권한입니다.

거래 권한

주문을 제출하거나 취소할 수 있는 권한입니다.

출금 권한

자산을 거래소 밖으로 보낼 수 있는 강한 권한입니다. 별도로 신중하게 관리해야 합니다.

메신저 연결 정보

PTE가 텔레그램이나 라인으로 보고서를 보내기 위해 필요한 비밀 연결값입니다.

백업

현재 프로젝트와 기록을 나중에 복구할 수 있도록 별도 파일로 보관하는 작업입니다.

복구

백업 파일을 이용해 저장된 프로젝트와 기록을 다시 불러오는 작업입니다.

고객지원용 진단 파일

문제 확인에 필요한 기술 정보만 모은 파일입니다. 비밀 연결 정보와 사용자 원본 파일은 제외합니다.

안전 잠금

필수 확인이 끝나지 않았거나 위험이 발견되어 실행을 막고 있는 상태입니다.

기준 데이터

현재 전략과 설정이 승인 이후 바뀌지 않았는지 확인할 때 사용하는 기준 정보입니다.

세계표준시

여러 지역에서 같은 기준으로 시간을 기록하기 위해 사용하는 국제 시간 기준입니다.

기술 이름 보기: UTC

텍스트 파일

일반 메모장으로 만들 수 있는 가장 단순한 문서입니다.

기술 이름 보기: .txt

마크다운 파일

제목과 목록 같은 간단한 형식을 사용할 수 있는 텍스트 문서입니다.

기술 이름 보기: .md

JSON

프로그램이 설정을 구조적으로 저장하는 형식입니다. 초보자가 직접 작성할 필요는 없습니다.

다음

안전 원칙과 위험 고지를 함께 확인하세요

실행 전에 무엇을 약속하지 않는지, 언제 멈추는지 다시 확인할 수 있습니다.