전략을 문장처럼 조립하고,
공식 엔진과 거래 장부로 대조합니다
QBench는 자동매매 전략을 필터·진입·크기·추가매수·청산으로 나눠 조립해 백테스트하고, "QBench에서 통과했다"가 "실거래도 같은 주문 의도를 낸다"는 뜻이 되도록 만드는 개인 작업대입니다.
무엇을 하는 도구인가
전략 조립
슬리브마다 필터·진입·크기·추가매수·청산을 문장 단위로 골라 DSL로 묶습니다. 같은 봉에 신호가 겹칠 때의 우선순위까지 결과에 포함됩니다.
기준값 재현
고정한 QBter 커밋의 공식 백테스트를 그대로 다시 돌려 같은 거래 수·수익률·MDD가 나오는지 먼저 확인합니다. 이게 모든 비교의 출발점입니다.
장부 단위 대조
진입 시각으로 거래를 짝지어 시각·가격·수익률·자본·첫 매수 비율·펀딩·청산 사유를 항목별로 맞춥니다. 자산 곡선의 상대 차이도 함께 봅니다.
왜 필요한가
전략을 고칠 때마다 구조와 로직이 같이 바뀌어서, 테스트를 통과해도 실거래가 같은 판단을 한다는 보장이 없었습니다. QBench는 그 간극을 두 방향으로 줄입니다.
- 아이디어를 빠르게 시험합니다. 파라미터와 조합을 바꿔 가며 돌려 보고, 저장한 전략끼리 같은 기간에 겹쳐 비교합니다.
- 검증을 재사용합니다. 한 번 장부 차이 0을 확인한 단계는 고정 fixture로 남겨, 다음 변경이 그 위에서 안전한지 확인합니다.
- 에이전트도 같은 코어를 씁니다. CLI와 JSON API가 화면과 같은 엔진을 호출하므로, 자동화로 찾은 전략도 같은 기준으로 검증됩니다.
검증 방식
공식 엔진(QBter 고정 커밋 2db37a63)과 QBench 엔진을 같은 조건으로 돌리고,
진입 시각으로 거래를 짝지어 장부를 맞댔습니다. 기능을 한 묶음씩 켜는 사다리를 올라가며 단계마다 차이 0을 확인했기 때문에,
마지막 단계의 일치는 우연이 아니라 누적된 결과입니다.
| 사다리 | 단계 | 거래 | 장부 차이 |
|---|---|---|---|
| 일봉 슬리브 (L0 → L19) | 20 | 191 | 0 |
| 횡보 슬리브 (S0 → S7) | 8 | 511 | 0 |
| Combined (QBench 단독) | — | 702 | 0 |
일봉 슬리브 191건은 공식 daily 설정과, 횡보 슬리브 511건은 공식 sideways 설정과 시각·가격·수익률·자본·펀딩이 모두 같습니다. 결합 곡선 1,962 거래일의 최대 상대 차이는 1.3e-11입니다.
설계상의 경계
화면
전략 만들기 · 결과 보기 · 전략 비교가 실제로 동작하고, 기준값 검증·거래 장부·실거래 재생·적용 검토 탭은 시안 단계입니다. 공개된 화면 시안은 기준값 검증 탭을 뺀 나머지가 예시 데이터로 채워져 있습니다.
qbench serve # http://127.0.0.1:8765/ (API 문서 /docs)
qbench backtest example:combined
qbench verify-baselines
qbench parity combined
로컬에서 도는 도구입니다. 공개 사이트에는 실행 화면 대신 검증 결과와 화면 시안만 올립니다.