5분 시작 가이드

코드를 몰라도 됩니다. AI 가 전략을 만들고, 당신은 결과를 보고 결정만 합니다. 순서는 다섯 단계입니다 — 홈의 시작 가이드 카드가 같은 순서로 진행을 따라옵니다.

1. 에이전트 연결하기 (한 번만)

백테스트·모의·실거래는 전부 내 기기에서 도는 작은 프로그램(에이전트) 이 실행합니다. 소리트레이딩 서버는 유저 전략을 실행하지 않고, 내 거래소 키도 주문도 만지지 않는 구조입니다(비수탁). 그래서 첫 백테스트 전에 에이전트가 있어야 합니다 — 브라우저 창을 열어두는 것만으로는 아무것도 실행되지 않습니다.

에이전트 관리에서 설치 명령 한 줄을 복사해 붙여넣으면 끝입니다. 어디에 설치할지:

• 지금 쓰는 PC — 가장 빨리 시작하는 방법입니다. 백테스트는 PC 와 에이전트가 켜져 있을 때 돌고, 꺼져 있으면 기다렸다가 다시 켜지면 돕니다.
• 저렴한 VPS(월 몇 달러) — 24시간 켜져 있어야 하는 모의·실거래에 맞습니다. 서버가 처음이면 서버 만들기 가이드(Amazon Lightsail · 약 15분)를 따라 하세요.

나중에 옮겨도 됩니다. 백테스트에 쓰는 봉은 에이전트가 거래소에서 직접 받아 내 기기의 캔들 저장소에 쌓고, 저장소에 없는 종목으로 백테스트를 걸면 그 자리에서 수집할지 묻습니다. 자세한 건 에이전트 문서.

2. AI 로 첫 전략 만들기

AI 전략 만들기에서 만드는 방식을 고르고 시작하세요. AI 가 종목·방식을 골라 전략을 만들고 과거 데이터로 시험까지 합니다(방향은 그 다음에 당신이 정하면 됩니다). 진행 상황은 화면 상단 알림으로 실시간으로 옵니다.

시작 전에 필요한 것: 전략을 만드는 건 외부 AI 입니다. 그 화면에서 AI 를 커넥터로 한 번 연결하거나(Claude·Grok 등 — 그 뒤로는 대화만 하면 되고 토큰을 채팅에 붙여넣지 않습니다), 내 AI 키를 등록해 여기서 돌리게 할 수 있습니다(요금은 AI 회사가 그 키로 청구합니다). 연결한 AI 는 내 전략을 읽고 고치고 페이퍼(모의)로 돌릴 수는 있지만, 실거래를 켜거나 실주문을 낼 수는 없습니다. 권한은 마이페이지 → AI 개발 토큰에서 언제든 끊을 수 있습니다.

3. 백테스트로 확인하기

완성된 전략은 전략 스튜디오에 나타납니다. 전략을 선택하고 백테스트를 누르면 과거 데이터로 시험합니다. 결과 읽는 법 두 가지만:

• 수익률 — 과거 구간의 시험 결과입니다. 미래 수익의 약속이 절대 아닙니다.
• MDD — 최고점에서 최대 몇 %까지 내려갔었나. 이 숫자만큼의 하락은 견딜 각오가 필요합니다.

종료일을 바꿔 다른 기간에서도 비슷한 결과가 나오는지 꼭 확인하세요 — 한 구간만 좋은 전략은 우연일 가능성이 큽니다.

결과 카드의 상세보기에서 더 깊이 봅니다: 성장·낙폭 곡선(같은 기간 단순 보유와 나란히), 월별 수익률 표·달력·연도별 표, 위험 지표(변동성·샤프·소르티노·칼마·가장 긴 손실 구간), 거래 통계(승률·평균 이익/손실·낸 수수료). 하루의 경계는 화면의 표시 시간대 기준입니다. 일별 기록은 에이전트 1.423.0 이상에서 돈 결과에만 있습니다.

이미 들고 있는 코인으로 전략을 시작할 계획이라면 고급 설정 → 시작 보유로 그 상태를 흉내 내 시험할 수 있습니다 — 첫 봉부터 그 수량을 들고 시작하고, 수익률 기준은 현금 + 수량 × 첫 시세입니다(단일 종목·현물·코드 전략만).

4. 모의로 돌려보기

전략 카드의 모의투자로 배포 버튼을 누르세요. 1단계의 에이전트에서 가짜 돈으로 실제 시세를 따라 돌아갑니다 — 실제 돈은 전혀 들어가지 않습니다. 돌아가는 모습은 홈(통합 현황)과 실행에서 봅니다.

5. 실거래는 준비되면

모의 결과가 며칠 이상 만족스러울 때만 넘어가세요. 실주문이 나가려면 셋이 다 있어야 합니다:

• 거래소 API 키 — 에이전트 관리에서 에이전트에 등록합니다. 출금 권한 없이 만드세요(예외와 이유는 보안).
• 지갑 크기(기준액) — 실행에서 실거래로 승격할 때 정합니다. 이 금액이 그 전략의 최대 손실입니다.
• 실주문 켜기 — 에이전트는 처음에 주문을 내지 않는 dry-run 입니다. 실주문은 따로 확인해서 켭니다.

선물 거래소 일부는 첫 실거래 전에 연결 시험(주문 왕복) 이 필요합니다 — 최소 수량의 실제 주문으로 주문 경로를 확인하는 단계라 수수료·가격 변동 손실이 생길 수 있습니다. 내 계정으로 메인넷에서 통과하면 그 계정은 바로 실거래를 쓸 수 있습니다(테스트넷 통과는 실거래를 열지 않습니다).

---

여기부터는 더 알고 싶을 때 읽는 내용입니다.

페이퍼 트레이딩(수동)

AI 전략 말고 직접 사고팔며 연습하고 싶다면 터미널의 페이퍼로. 가상 자금, 실제 시세·호가, 에이전트의 페이퍼 지갑(실거래와 같은 지갑 구조), 실제 같은 수수료·슬리피지. 페이퍼도 에이전트에서 돕니다.

터미널은 페이퍼와 실거래가 같은 화면이고(위 토글로 바꿉니다), 현재가·호가·체결·차트(과거 봉 포함)를 내 에이전트가 거래소에서 직접 받습니다 — 소리트레이딩 서버의 시세를 쓰지 않습니다. 그래서 아직 수집하지 않은 종목도 고르고 차트를 볼 수 있습니다(종목 목록에 '미수집'으로 표시). 마지막으로 본 시장·종목과 페이퍼/실거래 쪽을 이 기기에 기억해 다음에 그대로 엽니다. 외환은 지난번에 고른 MT 터미널(하나뿐이면 그 터미널)을 자동으로 고르고, 국내 주식은 지난번 종목 → 보유 종목 순으로 채웁니다. 실거래 쪽을 연 것만으로는 주문이 나가지 않습니다 — [실주문 켜기] 확인이 따로 있습니다.

페이퍼 · 가상 실거래 · 실거래 — 무엇이 다른가

이름이 비슷해서 헷갈리기 쉬운 셋입니다.

• 페이퍼(모의) — 가짜 돈으로 실제 시세를 따라 돕니다.
• 가상 실거래 — 실거래 쪽과 똑같이 사는 가짜 돈 실행입니다. 빈 지갑에서 시작해 allocator 의 미배정 지갑에서 돈을 받고, 승격하면 새 상태로 시작합니다 — 다만 돈이 가짜입니다.
• 실거래 — 진짜 돈으로 실제 주문이 나갑니다. 키·지갑 크기·실주문 켜기가 모두 있어야 하고, 기본은 주문을 내지 않는 dry-run 입니다.

짝: 같은 전략을 배포하면 늘 도는 페이퍼 쪽과 돈을 받는 위층(실거래 또는 가상 실거래)이 한 짝이 됩니다. 두 쪽은 같은 시세를 받지만 지갑과 상태는 따로입니다.

가상 실거래는 왜 있나: 페이퍼 allocator 배포가 실거래 배포와 같은 동작을 하게 하려고 있습니다. allocator 의 페이퍼 배포에서는 위층이 가상 실거래이고, 실거래 배포에서는 위층이 실거래입니다. 그래서 비중을 0 으로 받으면 위층은 줄이기만 하다가 비면 대기로 가지만, 페이퍼 쪽은 계속 돕니다 — 실거래 배포에서와 똑같습니다. allocator 없이도 실행의 짝 카드에서 가상 승격으로 직접 만들 수 있습니다(지갑 크기는 금액으로 정합니다). 지갑 화면에서는 '가상 실거래' 표가 붙은 계정으로 보입니다.

캔버스에서 보기: 실행의 캔버스 보기에서 브랜드색 실선은 돈이 오는 길(allocator·칸 → 위층)이고, 하늘색 점선은 짝(위층 ⇢ 같은 전략의 페이퍼 쪽)입니다. 짝 선을 따라서는 돈이 오가지 않습니다. 얼로케이터 자체는 얼로케이터 문서에서 설명합니다.

직접 코드를 쓰고 싶다면

전략은 onUpdate(ctx) 자바스크립트 함수 하나입니다. 에디터에 자동완성이 있고, 전략 API 문서에 전체 목록이 있습니다. 백테스트 호가는 캔들 변동성에서 합성한 근사치이므로 슬리피지 수치는 추정으로 보세요.

개발 노트 — 전략의 버전 관리

스튜디오에서 전략을 선택하면 개발 노트 탭이 있습니다. AI(자동 개발)나 내가 남긴 기록이 시간순으로 쌓이고, 기록마다 그 시점의 코드가 자동으로 저장됩니다 — 노트 타임라인이 곧 버전 히스토리입니다. 백테스트 이력에도 잡마다 실행 시점 코드가 남습니다.

각 기록의 버튼 세 개는 이렇게 다릅니다:

• 코드 — 그 시점 코드를 읽기만 합니다. 아무것도 바뀌지 않습니다.
• 에디터로 불러오기 — 그 시점 코드를 에디터에 임시로 올립니다. 저장된 전략은 그대로 두고, 위의 백테스트 실행으로 바로 돌려볼 수 있습니다. 다른 전략을 선택하거나 새로고침하면 사라집니다(저장 전까지 임시).
• 이 코드로 되돌리기 — 저장된 전략 자체를 그 시점 코드로 덮어씁니다. AI 가 코드를 이상하게 만들었을 때 쓰는 되돌리기이며, 되돌린 사실도 노트에 기록되므로 이력은 끊기지 않습니다.

정리하면: 구경만 = 코드, 돌려보기 = 에디터로 불러오기, 진짜 복구 = 되돌리기.

실거래 상세 — 지갑과 수익률

실거래 실행은 지갑(운용 기준액) 안에서만 주문합니다. 지갑을 다 쓰면 더 사지 못하고, 지갑 전체가 그 실행의 최대 손실입니다(손실이 나면 저절로 멈추는 킬스위치가 아니라, 지갑 크기 자체가 상한입니다). 주문 빈도 제한·수동 정지 같은 안전장치는 그대로 걸립니다.

수익률 — 오해하기 쉬운 부분: 실행의 수익률(%)은 계좌 전체가 아니라 그 실행의 기준액 대비입니다. 계좌에 1,000만 원이 있어도 기준액이 100만 원이면 전략은 100만 원만 굴리므로, 계좌 전체로 보면 수익이 작아 보일 수 있습니다 — 그건 전략이 아니라 기준액 때문입니다. 또 같은 거래소의 실거래 실행들은 잔고를 나눠 쓰므로, 기준액 합계가 잔고를 넘으면 주문이 잔고 부족으로 거부될 수 있습니다. 기준액은 나중에 바꿀 수 있고, 실거래는 바꾸기 전에 한 번 더 확인합니다.

처음 보는 단어들

여기 나오는 말 중 낯선 게 있으면 여기서 찾으세요. 몰라도 시작할 수는 있지만, 실거래 전에는 읽어보시길 권합니다.