백테스트한 전략을
실전으로 옮기기
웹에서 검증한 전략·파라미터·포트폴리오 비중을 같은 코어 코드로 실행합니다. 실전에서 달라지는 체결 조건을 먼저 이해하고, 페이퍼 계좌로 확인한 뒤 소액 실거래로 전환하세요.
실전 러너는 이렇게 동작합니다
1같은 전략 신호 계산
웹 백테스터와 실전 러너가 전략·지표·시그널·포트폴리오 모듈을 함께 사용합니다. 내보낸 파라미터와 비중으로 각 종목의 목표 보유 상태를 계산합니다.
2목표 비중을 주문으로 변환
진입·청산 신호와 현재 보유량의 차이를 주문으로 바꿉니다. 최소 주문금액과 리밸런싱 밴드 때문에 아주 작은 비중 차이는 거래하지 않을 수 있습니다.
3시장별 시점에 실행
크립토는 일봉 확정 후 실행합니다. 국내·미국 주식은 종가 부근 체결을 위해 마감 약 11분 전 잠정 신호로 주문하고, 마감 약 20분 후 확정 봉으로 다시 확인해 차이가 있으면 교정합니다. 러너를 시작·재시작하면 기본적으로 다음 정규 매매 시점까지 기다립니다.
4기록하고 사후 검증
시그널·주문·체결·평가액을 로컬에 기록합니다. 2~4주 운용 후 검증 명령을 실행하면 백테스트 대비 시그널 일치율·슬리피지·추적오차를 확인할 수 있습니다.
백테스트와 같은 것 · 달라지는 것
| 그대로 가져오는 것 | 종목, 전략, 파라미터, 수수료 가정, 포트폴리오 비중 규칙 |
|---|---|
| 실전에서 달라지는 것 | 실제 체결가·슬리피지, 주문 최소금액·호가 단위, 환율, 네트워크 지연, 거래소 점검과 휴장 |
| 주식 잠정 신호 | 마감 전 가격을 종가처럼 사용하므로 확정 봉에서 신호가 바뀔 수 있습니다. 바뀌면 러너가 교정 주문과 알림을 남깁니다. |
| 수익 보장 | 백테스트 성과는 미래 수익을 보장하지 않습니다. 실전 차이는 검증 리포트로 확인하고 충분한 페이퍼 기간을 거치세요. |
실행 환경 선택
내 PC 간단한 시작
별도 서버 비용 없이 바로 시험하기 좋습니다. 단, 컴퓨터가 깨어 있고 인터넷에 연결된 동안만 정상적으로 실행됩니다.
- 적합: 페이퍼 테스트, 초기 소액 검증
- 주의: 절전·로그아웃·네트워크 단절
내 VPS + Docker 24시간 · 권장
사용자가 관리하는 리눅스 서버에서 무인 운용합니다. 전략 설정은 6자리 코드로 가져오며 API 키는 코드에 포함되지 않습니다.
- 적합: 24시간 지속 운용
- 비용: VPS에 따라 월 약 5달러부터
설치 1 — 웹에서 설정 내보내기
포트폴리오 모드 → 백테스트 → ⬇ 실전 설정
웹 백테스터에서 포트폴리오를 구성·백테스트한 뒤 차트 옆 ⬇ 실전 설정을 누르세요.
- 내 PC — 내려받은
backtester-live-config.json을 마법사에서 선택 - 클라우드 — 버튼 옆에 표시되는 6자리 설치 코드를 서버 마법사에 입력 (24시간 유효, 전략 구성만 포함 · API 키 없음)
설정 없이 설치할 수도 있지만 전략을 다시 골라야 합니다. 백테스트한 구성을 그대로 쓰려면 먼저 내보내세요.
설치 2 — 실행 환경에 설치하기
macOS / Linux PC
필수: Node.js 20 이상. Node가 없고 Docker가 설치되어 있으면 설치기가 Docker 방식으로 전환합니다.터미널에 붙여넣으세요. 마법사가 뜨면 내보낸 설정 파일을 선택합니다.
curl -fsSL https://sleepwelltrade.com/install.sh | bashWindows PC
필수: Node.js 20 이상. 없다면 PowerShell에서winget install OpenJS.NodeJS.LTS 실행 후 새 터미널을 여세요.
PowerShell에 붙여넣으세요. 마법사에서 내려받은 설정 파일을 선택합니다.
irm https://sleepwelltrade.com/install.ps1 | iexLinux VPS + Docker 24시간 · 권장
필수: SSH 접속 가능한 Linux VPS. Docker가 없으면 설치기가 공식 설치 여부를 묻습니다.서버 터미널에 붙여넣고 웹에서 받은 6자리 설치 코드를 입력하세요. Node.js는 필요 없습니다.
curl -fsSL https://sleepwelltrade.com/install.sh | bash -s -- --docker설정·API 키·거래 기록은 VPS의 ~/backtester-live/data에 저장됩니다.
로그: docker compose logs -f runner · 설정 변경: bash setup-docker.sh
원라이너를 실행하기 전에 확인하고 싶다면
설치 명령은 원격 스크립트를 내려받아 실행합니다. 내용을 먼저 확인하거나 압축 파일을 직접 받을 수 있습니다.
· macOS:
sudo pmset -c sleep 0 (전원 연결 시)· Windows:
powercfg /change standby-timeout-ac 0 + powercfg /change hibernate-timeout-ac 0· Linux 데스크톱:
sudo systemctl mask sleep.target suspend.target hibernate.target설치 3 — 마법사와 첫 실행
- 전략 불러오기 — PC는 설정 파일, 클라우드는 6자리 코드
- 모드 선택 — 먼저 페이퍼 권장, 준비되면 실거래
- 실거래 안전장치 — 배정 최대 금액과 일일·고점대비 손실 한도
- 거래소 API 키 — 실거래일 때만 입력, 조회+주문 권한만 허용
- 텔레그램 — 선택 사항, 체결·오류 알림과 원격 제어
- 동작 확인 — 실거래는 주문 없는 드라이런, 페이퍼는 가상 주문 1회
- 설정 적용 — 저장한 설정으로 실행 중인 러너를 시작·재시작할지 선택. 지금 재시작하지 않아도 이후 장애·재부팅으로 다시 뜰 때 새 설정 적용
- 첫 실행 시점 — 다음 정규 매매 시점까지 대기(권장), 또는 최신 확정봉 기준 지금 1회 실행
- 상시 실행 — 동의하면 부팅·로그인 시 시작과 실패 시 재시작 등록
나중에 바꾸려면 PC: node live/setup.mjs · Docker: bash setup-docker.sh
주의: 실거래 모드의 “지금 1회 실행”은 연결 테스트가 아닙니다. 현재 보유량과 목표 비중의 차이에 따라 실제 매수·매도·리밸런싱 주문이 나갈 수 있으므로 드라이런 계획과 최대 배정금액을 먼저 확인하세요.
안전과 개인정보
API 키
키는 운영 중인 PC 또는 사용자가 관리하는 VPS의 secrets.json에 저장되며 백테스터 서비스 서버로 업로드하지 않습니다.
파일 권한은 가능한 환경에서 소유자 전용으로 설정됩니다.
거래 권한
조회와 주문 권한만 허용하고 출금 권한은 절대 주지 마세요. 거래소가 지원한다면 실행 PC/VPS의 고정 IP도 허용 목록으로 제한하세요.
킬스위치
기본값은 일일 -10% 또는 고점 대비 -25%입니다. 한도를 넘으면 전량 청산 후 정지하며 마법사에서 더 보수적으로 바꿀 수 있습니다.
익명 사용 통계
설치·기동 정보와 익명 러너 ID, OS, 버전, 모드, 종목 수·거래소 종류, heartbeat, 정규 실행의 성공·스킵·실패 및
주문 성공·실패 건수를 전송합니다. API 키·잔고·금액·수량·종목명·주문 ID·텔레그램 내용은 포함하지
않습니다. 오류 문구는 인증값·URL 쿼리·긴 식별자와 숫자를 제거합니다. 설정의
"telemetry": false로 끌 수 있습니다.
운영 중 자주 묻는 것
설정을 바꾸면 언제 적용되고 언제 주문하나요?
설정 파일을 저장해도 이미 실행 중인 프로세스는 자동으로 바뀌지 않습니다. 마법사 마지막 단계에서 새 설정으로 시작·재시작해야 즉시 적용됩니다. 재시작을 미루면 현재 프로세스는 이전 설정을 유지하지만, 이후 장애·서버 재부팅 등으로 자동 재시작될 때 저장된 새 설정이 적용됩니다. 기본값은 다음 정규 매매 시점까지 대기입니다. “지금 1회 실행”을 고르면 최신 확정봉과 현재 보유량을 기준으로 즉시 동기화하며, 실거래에서는 실제 매수·매도 주문이 나갈 수 있습니다. 주식은 거래시간 밖이면 주문이 거절될 수 있습니다.
전략·포트폴리오를 바꾸려면?
웹에서 다시 백테스트 → 실전 설정 내보내기 → 마법사 재실행 순서입니다. 빠진 종목을 보유 중이면 봇은 더 이상 그 종목을 관리하지 않으므로
교체 전에 텔레그램 /exit confirm 또는 수동 매도로 정리하세요.
실전과 백테스트가 얼마나 일치하는지 확인하려면?
텔레그램을 연결했다면 /verify(또는 제어판의 ✅ 백테스트 대비 검증 버튼)로 시그널 일치율·슬리피지·수익률 추적 요약을 바로 받아볼 수 있습니다.
상세 마크다운은 2~4주 기록을 쌓은 뒤 node live/report.mjs --config live/config.json으로 저장하세요.
Docker에서는 docker compose run --rm runner node live/report.mjs --config data/config.json처럼 컨테이너 안에서 실행할 수 있습니다.
시그널은 백테스트와 같아야 하고, 수익은 슬리피지·현금드래그로 달라질 수 있습니다.
무료인가요?
현재 배포 버전은 페이퍼·실거래 모두 무료 개방 중입니다. 페이퍼 모드는 항상 무료이며 향후 새 버전의 실거래 기능에는 라이선스가 도입될 수 있습니다.
문제가 생기면 어떻게 멈추나요?
텔레그램을 연결했다면 /pause로 신규 주문을 멈추고, /exit confirm으로 포트폴리오를 전량 청산할 수 있습니다.
텔레그램을 연결하지 않았다면 실행 서비스를 중지하고 거래소에서 직접 주문·보유 상태를 확인하세요.
백테스트 성과는 미래 수익을 보장하지 않으며 투자 손실은 사용자 책임입니다.