QBench큐벤치
Phase 1 검증 완료 · 2026-11-15

전략을 문장처럼 조립하고,
공식 엔진과 거래 장부로 대조합니다

QBench는 자동매매 전략을 필터·진입·크기·추가매수·청산으로 나눠 조립해 백테스트하고, "QBench에서 통과했다"가 "실거래도 같은 주문 의도를 낸다"는 뜻이 되도록 만드는 개인 작업대입니다.

대조한 거래
702건
공식 엔진과 장부 차이 0
누적 수익률 (ROI)
4,121,690%
QBter 공식값과 일치
종가 기준 MDD
15.01%
Sharpe 4.24
기준값 재현 테스트
89 PASS
6 skipped (느린 단계)

무엇을 하는 도구인가

전략 조립

슬리브마다 필터·진입·크기·추가매수·청산을 문장 단위로 골라 DSL로 묶습니다. 같은 봉에 신호가 겹칠 때의 우선순위까지 결과에 포함됩니다.

기준값 재현

고정한 QBter 커밋의 공식 백테스트를 그대로 다시 돌려 같은 거래 수·수익률·MDD가 나오는지 먼저 확인합니다. 이게 모든 비교의 출발점입니다.

장부 단위 대조

진입 시각으로 거래를 짝지어 시각·가격·수익률·자본·첫 매수 비율·펀딩·청산 사유를 항목별로 맞춥니다. 자산 곡선의 상대 차이도 함께 봅니다.

왜 필요한가

전략을 고칠 때마다 구조와 로직이 같이 바뀌어서, 테스트를 통과해도 실거래가 같은 판단을 한다는 보장이 없었습니다. QBench는 그 간극을 두 방향으로 줄입니다.

검증 방식

공식 엔진(QBter 고정 커밋 2db37a63)과 QBench 엔진을 같은 조건으로 돌리고, 진입 시각으로 거래를 짝지어 장부를 맞댔습니다. 기능을 한 묶음씩 켜는 사다리를 올라가며 단계마다 차이 0을 확인했기 때문에, 마지막 단계의 일치는 우연이 아니라 누적된 결과입니다.

사다리단계거래장부 차이
일봉 슬리브 (L0 → L19)201910
횡보 슬리브 (S0 → S7)85110
Combined (QBench 단독)—7020

일봉 슬리브 191건은 공식 daily 설정과, 횡보 슬리브 511건은 공식 sideways 설정과 시각·가격·수익률·자본·펀딩이 모두 같습니다. 결합 곡선 1,962 거래일의 최대 상대 차이는 1.3e-11입니다.

설계상의 경계

QBench에는 거래소 키, EC2, 배포 권한이 없습니다. QBter는 커밋으로 고정한 읽기 전용 의존성이고, 시장 데이터는 바이낸스 선물 공개 API(키 불필요)만 씁니다. 전략 적용은 QBench가 보여 준 결과를 사람이 확인한 뒤 QBter 쪽 PR로 진행합니다.

화면

전략 만들기 · 결과 보기 · 전략 비교가 실제로 동작하고, 기준값 검증·거래 장부·실거래 재생·적용 검토 탭은 시안 단계입니다. 공개된 화면 시안은 기준값 검증 탭을 뺀 나머지가 예시 데이터로 채워져 있습니다.

qbench serve                 # http://127.0.0.1:8765/  (API 문서 /docs)
qbench backtest example:combined
qbench verify-baselines
qbench parity combined

로컬에서 도는 도구입니다. 공개 사이트에는 실행 화면 대신 검증 결과와 화면 시안만 올립니다.