본문으로 건너뛰기

다음 단계

여기까지 따라왔다면 quant-ai의 페이퍼 트레이딩 + AI 분석 + 백테스트 루프를 한 번씩 모두 실행해 본 상태입니다. 이제 본격적인 운영을 위해 다음 항목을 차례대로 학습하세요.

1. 라이브 모드 게이트​

quant-ai는 페이퍼 검증 없이 라이브 거래를 허용하지 않습니다.

게이트기준
페이퍼 운영 기간최소 90일 연속 (자산군별 독립)
페이퍼 누적 거래50건 이상 체결
핵심 지표max_drawdown >= -25%, sharpe_ratio >= 0.5
환경 변수FEATURE_EQUITY_LIVE=true
사용자 토글Settings → Live Mode 에서 자산군별 2-step 활성화
일일 한도LIVE_DAILY_TRADE_LIMIT (기본 10건/자산군/일)

세 조건이 모두 충족되어야 첫 라이브 주문이 허용되고, 첫 주문에는 자동으로 first_live_order 마커가 audit 로그에 남습니다 (Telegram 알림 권장).

자세한 절차: 페이퍼 → 라이브 승격.

절대 룰

거래당 1-2% 리스크, 일일 -5% 자동 중단, 최대 레버리지 3배 룰은 페이퍼/라이브 모두 동일하게 적용 됩니다.

2. 멀티자산 활용​

자산군별 워크플로우는 별도 튜토리얼에 정리되어 있습니다.

튜토리얼다루는 내용
Crypto 모멘텀 봇BTC/USDT 4h 모멘텀 전략 + 24/7 운영 + Funding 룰
US Equity 분석AAPL/NVDA 멀티 에이전트 분석 + Earnings 캘린더 + RTH 게이트
KR Equity 분석005930/035720 + 동시호가/장중 시간대 + 거래 정지 처리
멀티자산 포트폴리오3개 자산군 동시 운영, 통화 변환, 자산군별 리스크 한도
커스텀 전략BaseStrategy 상속, RL 에이전트 학습, 백테스트 통과시키기

3. 운영 모니터링​

페이퍼/라이브 봇이 24/7 돌기 시작하면 다음 요소를 항상 모니터링하세요.

Grafana 대시보드​

기본 대시보드 (포트 30300):

  • Bot Health — 봇 상태, 시그널/주문 비율, 실패율
  • Equity Curve (Live) — 자산군별 실시간 잔고
  • LLM Cost — 사용자별 일일 분석 비용
  • Risk Breaches — 1-2% / -5% / -25% 위반 카운터

자세히: Grafana 대시보드.

Telegram 알림​

다음 이벤트는 항상 켜두는 것을 권장합니다:

events:
  - order_filled
  - order_rejected
  - daily_loss_breach        # -5% 일일 한도 도달
  - bot_stopped               # 봇이 중단됨 (자동/수동)
  - first_live_order          # 첫 라이브 주문 (라이브 단계)
  - kis_token_expired

설정: Telegram 알림.

Health Check​

GET /api/health (인증 불필요)는 다음을 반환합니다:

{
  "status": "ok",
  "db": "ok",
  "redis": "ok",
  "broker_router": {
    "crypto": "ok",
    "us_equity": "ok",
    "kr_equity": "degraded"
  }
}

자세히: 헬스 체크.

4. 비상 대응​

상황가이드
일일 -5% 도달, 봇이 자동 STOPEmergency stop
거래소 401 (키 만료/회수)Broker 401
포지션 불일치 (broker ↔ DB)Position reconciler
LLM 비용 폭주LLM budget exceeded
시크릿 회전 후 키 복호화 실패Secret rotation

5. 추가 자료​

다음 단계: 자산군 운영 패턴이 궁금하다면 Crypto 모멘텀 봇 튜토리얼로 이동하세요.