오프라인 Pine Script 백테스트: 동일한 트레이드 48건

브라우저 백테스트는 차트 옆에서 빠르게 반복해 보기에 좋습니다. 오프라인 백테스트는 다음 단계가 전략에 돈을 싣는 일일 때 손이 갑니다. 감사 추적이 필요할 때, CI로 모든 커밋에 게이트를 걸어야 할 때, 두 달 전 결과가 오늘도 트레이드 하나하나까지 그대로 재현돼야 할 때죠.

오프라인으로 돌리면 브라우저 테스터가 못 주는 게 생깁니다: 결과가 결정론적입니다. 스크립트, 데이터, 이미지 버전이 같으면 트레이드도 같습니다. 이미지 버전을 고정하고, 리포트를 저장소에 커밋하고, 커밋 사이의 트레이드 목록을 디프하고, 이 모든 걸 CI에서 헤드리스로 돌리면 됩니다. 넣는 CSV는 내 것이고, 엔진은 로컬에서 돌며, 리포트에는 그 결과를 만든 요소의 핑거프린트가 기록됩니다.

실제로 얻는 것들: 이미지 버전을 고정하므로 두 달 전 커밋도 오늘 같은 트레이드 목록을 냅니다. OHLCV이기만 하면 거래소 캔들부터 틱을 모아 직접 만든 봉까지 내 데이터를 쓸 수 있습니다. 회귀가 생기면 CI 검사가 빌드를 실패시킵니다. 그리고 전략은 특정 플랫폼에 묶이지 않는 파일로 남습니다.

백테스트 결과를 동료와 나눠야 하는데 ‘공유’할 방법이 차트 스크린샷뿐이라는 걸 깨달은 적이 있다면, 빠진 조각은 바로 오프라인 실행입니다.

PineForge는 PineScript v6를 네이티브 C++로 트랜스파일하고, Docker 이미지 하나로 내 머신에서 실행합니다.

세 단계면 됩니다. 이미지는 한 번만 받으면 되고, 그 뒤로는 모든 과정이 오프라인에서 돌아갑니다.

1단계: 런타임 받기

이미지는 ghcr.io/pineforge-4pass/pineforge-release 하나입니다. pip도, 키도, 가입도 필요 없습니다. 트랜스파일, 컴파일, 백테스트가 모두 이미지 안에서 오프라인으로 돌아갑니다. 이미지 안의 엔진은 Apache-2.0이고, 함께 들어 있는 트랜스파일러는 개인 트레이딩에 무료입니다.

2단계: 내 Pine을 C++로 트랜스파일하기

이미지를 트랜스파일 전용 모드로 실행하면 PineScript v6를 로컬에서 완결된 C++ 소스 파일로 바꿔 줍니다. 백테스트할 때 Pine 인터프리터는 돌지 않습니다. 이미지가 C++를 네이티브 코드로 컴파일합니다.

docker run --rm --network=none \
  -e PINEFORGE_TRANSPILE_ONLY=1 \
  -v "$(pwd)/my_strategy.pine":/in/strategy.pine:ro \
  ghcr.io/pineforge-4pass/pineforge-release:1.10.0 > strategy.cpp

3단계: 백테스트하기

생성된 C++ 옆에 OHLCV CSV를 마운트하고 이미지를 실행하세요. CSV에는 timestamp,open,high,low,close,volume 헤더가 있어야 하고, 타임스탬프는 UNIX 밀리초 단위입니다. 엔진이 전략을 봉 단위로 실행하고 JSON 리포트를 stdout으로 출력합니다. 2단계는 건너뛰어도 됩니다. 대신 strategy.pine을 마운트하면 이미지가 먼저 트랜스파일합니다.

docker run --rm --network=none \
  -v "$(pwd)/strategy.cpp":/in/strategy.cpp:ro \
  -v "$(pwd)/ohlcv.csv":/in/ohlcv.csv:ro \
  ghcr.io/pineforge-4pass/pineforge-release:1.10.0 > report.json

JSON 리포트에는 요약 블록(총 트레이드 수, 승패 수, 승률, 순손익, 최대 낙폭), 전체 트레이드 목록(진입과 청산 시각, 가격, 수량, 손익, 봉 인덱스), 프로핏 팩터, 샤프 지수, 소르티노 지수 같은 지표, 에퀴티 커브, 그리고 실행에 쓰인 엔진, 트랜스파일러, 입력값, 데이터의 핑거프린트(계산할 수 없으면 null)가 들어 있습니다.

워크플로 전부입니다. GUI 없음, 재인증 없음, 차트 로딩 없음. Docker만 되면 PineForge 오프라인 백테스트도 됩니다.

짧게: OHLCV로 직렬화할 수 있는 것이라면 무엇이든. PineForge는 시세 벤더와 직결돼 있지 않습니다. 데이터를 가져오면 엔진이 전략을 실행합니다.

• 내 거래소 크립토. Binance, Bybit, Kraken, 혹은 REST/WebSocket API 있는 거래소에서 원시 체결 데이터를 가져와 전략 타임프레임으로 집계하고 CSV를 바로 넣습니다. 실제로 거래할 페어·장소 조합으로 테스트합니다.
• 틱으로 만든 봉. 틱이나 호가창 데이터로 봉을 만든다면 OHLCV로 넣으면 됩니다. 엔진은 봉이 어디서 왔는지 따지지 않습니다.
• 다른 시계열. 엔진은 timestamp, open, high, low, close, volume만 읽고 그 밖의 열은 무시합니다. 센티먼트 점수나 온체인 지표는 이 열에 인코딩해야만 백테스트할 수 있습니다.