quant-ai 가이드
quant-ai는 비트코인 + 미국/한국 주식을 단일 운영 평면에서 다루는 멀티자산 AI 자동매매 시스템입니다. RL 기반 적응형 전략 엔진, AI 분석/리포트, 페이퍼/실전 모드 게이팅, Grafana + Telegram 모니터링을 통합 제공합니다.
본 가이드는 G0 단계 스캐폴딩입니다. 각 섹션의 상세 본문은 G1~G4 단계에서 채워질 예정입니다.
빠른 시작
| 항목 | 설명 |
|---|---|
| 10분 퀵스타트 | quant-ai 핵심 기능을 10분 안에 체험 |
| 페이퍼 트레이딩 셋업 | 거래소 페이퍼 키 등록 |
| 첫 AI 분석 | 자연어 질문 → 종목 리포트 |
| 첫 백테스트 | 전략을 과거 데이터에 검증 |
주요 기능
- 멀티자산 거래 — Crypto (Binance/Bybit/OKX) + US Equity (Alpaca) + KR Equity (KIS)
- AI 분석/리포트 — LiteLLM 프록시 기반 종목 리포트 + Text-to-Strategy
- 백테스트 엔진 — vectorbt + walk-forward 검증 + 프로파일 저장/로드
- 리스크 룰 — 거래당 1~2%, 레버리지 ≤3x, 일일 손실 5% → 자동 중단
- 모니터링 — Grafana 대시보드 + Telegram 알림 + 헬스체크
- 멀티유저 격리 — JWT 인증 + 사용자별 봇/키/포지션 분리
문서 구성
| 섹션 | 설명 | 대상 |
|---|---|---|
| 시작하기 | 퀵스타트, 페이퍼 키, 첫 분석/백테스트 | 모든 사용자 |
| 튜토리얼 | 시나리오별 step-by-step (크립토/주식/멀티자산) | 모든 사용자 |
| 기능 가이드 | 메뉴별 상세 사용법 (대시보드/주식/백테스트/포지션 등) | 사용자/분석가 |
| 운영 가이드 | 설치, 환경 설정, 모니터링, 트러블슈팅 | 관리자 |
| API 레퍼런스 | REST / WebSocket 엔드포인트별 상세 | 개발자 |
| 부록 | 용어집, 리스크 룰, 지원 브로커, FAQ, 변경 이력 | 전체 |
안전 수칙
- 페이퍼 트레이딩 최소 3개월 검증 후 실전 투입
- 일일 손실 5% 도달 시 자동 거래 중단
- 레버리지는 최대 3배 까지만 허용
- API 키는 암호화 저장, 시크릿 로테이션 시 영향 분석 필수
자세한 내용은 리스크 룰 참조.