LLM-in-the-loop · Trading Harness · Open Source
OPEN-TRADER
증권사 OpenAPI 문서만 넣으면 Claude가 브로커 어댑터를 자동 생성·검증해 연결하고, 자연어 전략을 두뇌(Claude)에 물려 페이퍼 트레이딩으로 돌리는 로컬 골격입니다.
비너스가 바다에서 태어나듯 — 진짜 제품은 전략이 아니라 하네스 그 자체입니다.
See It in Action
❯ npm start
[ Onboard ] 브로커 OpenAPI 문서 분석 → 어댑터 생성
→ 정적검사 · 컴파일 · 읽기전용 연결(인증·시세·잔고) 통과
[ Cycle ] 09:30 · Claude 판단 요청 (시세 + 포지션 + 전략)
→ 005930 삼성전자 : 지표 약세, 관망
→ 000660 SK하이닉스 : 분할매수 신호
[ Guardrail ] maxOrderPct 10% · dailyLoss 3% 통과
[ Paper ] BUY 000660 ×10 @ 178,000 (가상 체결)
✓ 사이클 완료 — 가드레일 7종 통과 · 대시보드 실시간 갱신
정직한 점수판 · 벤치마크 대비-0.4%p절대 수익률이 아니라 동일가중 buy-and-hold 대비 초과수익으로 평가합니다. 이 값은 대부분 음수일 것이고, 그게 정상입니다.
총자산10,420,000
일손익+0.2%
모드PAPER
Features
어댑터 자동생성
증권사 OpenAPI 문서만으로 TypeScript 어댑터를 생성하고, 정적검사·컴파일·읽기전용 연결 테스트로 검증합니다.
코드 가드레일
돈이 움직이는 경로는 AI 생성 코드가 아닌 결정론적 TypeScript로만 구성됩니다. 포지션·주문·일일 손실 한도.
실시간 관측성
모든 판단·체결·스냅샷이 기록되고, 토스 스타일 로컬 대시보드에서 SSE로 실시간 표시됩니다.
claude-in-the-loop
시세·포지션·전략을 프롬프트로 묶어 장중 30분 간격으로 Claude의 판단을 받아오는 사이클 엔진.
기본값 = 안전
모든 에러·예외의 기본 동작은 '거래 안 함'. v1은 3중 잠금을 풀어도 라이브 주문을 실행하지 않습니다.
BYO 전략
내장 베이스라인은 참고용일 뿐. strategy/*.md에 자연어 전략을 직접 써 교체하는 것이 전제입니다.
Commands & Guardrails
플러그인 커맨드
/trade-setup첫 온보딩 — 의존성 설치 후 온보딩 서버 시작/trade-start운영 데몬 백그라운드 시작 + 대시보드/trade-status자산 · 일손익 · 벤치마크 대비 · 포지션 요약/trade-stop데몬 정상 종료/trade-backtest과거 캔들 백테스트동작 3단계
온보딩OpenAPI 문서 + 키 → 어댑터 생성 · 검증전략 설정자연어 전략 Markdown 업로드 (BYO 권장)운영장중 30분 간격 판단 → 가드레일 → 가상 체결가드레일 (config.json)
maxPositionPct종목당 최대 비중 20%maxOrderPct1회 주문 금액 상한 10%dailyLossLimitPct일일 손실 한도 3% — 도달 시 당일 중단maxTotalExposurePct총 주식 노출 상한 80%라이브 3중 잠금
config.jsonmode: "live" 설정LIVE_CONFIRM=1환경변수 명시적 확인계좌 끝 4자리API로 계좌번호 확인v1 차단셋 다 맞아도 v1은 페이퍼만 — 의도된 안전장치교육·연구 목적의 오픈소스입니다
매매 판단과 그로 인한 모든 손실은 사용자 본인의 책임이며, 어떠한 투자 수익도 보장하지 않습니다. 기본 동작 모드는 페이퍼 트레이딩(가상 체결)이고, 생성된 어댑터의 주문 경로는 미검증이므로 라이브 전 사람이 직접 검토하세요. MIT License.