quant-ai에서 사용하는 핵심 용어를 카테고리별로 정리합니다.
자산군 (Asset Class)
| 용어 | 설명 |
|---|
crypto | 암호화폐. 주로 BTC/USDT 페어. CCXT 통합 (Binance/Bybit/OKX) |
us_equity | 미국 주식. Alpaca paper/live API |
kr_equity | 한국 주식. KIS 모의투자 / 실투자 API |
| Asset Class enum | src.core.asset_class.AssetClass. 심볼 prefix로 자동 추론 (KS: → kr_equity 등) |
운영 모드
| 용어 | 설명 |
|---|
| 페이퍼 (paper) | 거래소가 제공하는 시뮬레이션 환경 (Binance Testnet, Alpaca Paper, KIS 모의투자). 실제 자금 미사용 |
| 라이브 (live) | 실제 자금이 투입되는 모드. FEATURE_EQUITY_LIVE + 사용자별 live_enabled ON 필요 |
| 페이퍼 90일+50거래 | 라이브 활성화 readiness 기준. CLAUDE.md 절대 룰 |
시장 데이터
| 용어 | 설명 |
|---|
| OHLCV | Open / High / Low / Close / Volume. 캔들 데이터의 5개 컬럼 |
| Tick | 호가창 갱신 단위 |
| Bid/Ask | 매수/매도 호가 |
| 슬리피지 (slippage) | 의도 가격과 체결 가격의 차이. 백테스트는 slippage_bps (bps = 0.01%)로 모델링 |
| 호가 단위 (tick size) | 가격이 변동할 수 있는 최소 단위. KRX는 가격대별 다름 |
| 워치리스트 | 사용자가 즐겨찾기한 종목 목록 |
주문 / 체결
| 용어 | 설명 |
|---|
| Market | 시장가. 즉시 체결 |
| Limit | 지정가. limit_price 이내 가격에서만 체결 |
| Stop | 역지정가. stop_price 도달 시 시장가 발동 |
| Stop Limit | stop + limit 조합. stop_price 도달 시 limit 주문 등록 |
| TIF (Time-in-Force) | day/gtc/ioc/fok 주문 유효 기간 |
| Bracket | 진입 주문에 TP (take_profit) + SL (stop_loss) 동시 attached |
| OCO (One-Cancels-Other) | 두 주문 중 하나 체결 시 다른 하나 자동 취소 |
| client_order_id | 사용자/서버 발급 멱등성 키 |
| broker_order_id | 브로커가 발급하는 주문 식별자 |
리스크 / PnL
| 용어 | 설명 |
|---|
| 거래당 리스크 | (entry - stop_loss) * qty / equity. 1-2% 룰 (CLAUDE.md) |
| 일일 PnL | 자정(UTC) 이후 누적 손익 |
| 일일 -5% 룰 | 자산군 합산 일일 PnL이 -5% 도달 시 자동 거래 중단 (절대 룰) |
| 레버리지 | 최대 3배 (CLAUDE.md). 페이퍼는 일반적으로 1x |
| Drawdown | 최고점 대비 하락폭 |
| Sharpe ratio | 초과수익 / 표준편차. > 1이면 양호 |
| Profit factor | 총 이익 / 총 손실 절댓값 |
| RiskManager v2 | validate_signal_v2() — 1-2% / -5% / market closed / insufficient funds 통합 검증 |
인프라 / 시스템
| 용어 | 설명 |
|---|
| BotManager | 사용자별 trading bot 인스턴스. asyncio Task 기반 |
| BotRegistry | user_id → BotManager 매핑. 멀티유저 격리의 핵심 |
| BrokerRouter | asset_class → BaseBroker 라우터. user별로 각각 보유 |
| Broker Lease | 사용자별 broker 인스턴스 점유 |
| Heartbeat | 봇 살아있음 신호. timeout 시 자동 재시작 |
| feature flag | FEATURE_EQUITY_ANALYSIS / FEATURE_EQUITY_PAPER / FEATURE_EQUITY_LIVE / FEATURE_LLM_ANALYSIS 등 |
시장 캘린더
| 코드 | 시장 | 영업일 | 시간 (현지) |
|---|
XNYS | NYSE/NASDAQ | 월–금 (휴장일 제외) | 09:30–16:00 ET |
XKRX | KRX (KOSPI/KOSDAQ) | 월–금 (휴장일 제외) | 09:00–15:30 KST |
24h | 암호화폐 | 매일 | 24시간 |
11 빌트인 전략
| 이름 | 한글/중문 | 카테고리 |
|---|
ma_golden_cross | 균선금반 (均线金叉) | trend |
volume_breakout | 방량돌파 (放量突破) | trend |
box_oscillation | 박스 (箱体震荡) | framework |
bull_trend | 불 트렌드 (默认多头趋势) | trend (default) |
shrink_pullback | 축소되돌림 (缩量回踩) | trend |
bottom_volume | 저점 거래량 (底部放量) | reversal |
dragon_head | 용두 (龙头) | trend |
chan_theory | 전론 (缠论) | framework |
wave_theory | 파동 (波浪理论) | framework |
emotion_cycle | 정서 사이클 (情绪周期) | framework |
one_yang_three_yin | 일양삼음 (一阳夹三阴) | pattern |
자세한 내용은 지원 전략 참조.
분석 / 결정
| 용어 | 설명 |
|---|
| 보고서 (report) | 멀티 에이전트 분석 결과. UUID로 식별 |
| 에이전트 trace | 각 에이전트의 단계별 추론 + 토큰/지연 메타 |
| Decision Signal | buy / hold / sell |
| Confidence | 0.0–1.0 |
| Sentiment Score | -100 ~ +100 (감성) |
| Mode | quick / standard / full (분석 깊이) |
인증 / 보안
| 용어 | 설명 |
|---|
| JWT | RFC 7519. access (30m) + refresh (7d) |
| AUTH_SECRET_KEY | JWT 서명 키. 변경 시 모든 토큰 무효화 |
| ENCRYPTION_SALT | 거래소 키 암호화 salt. 변경 시 기존 키 복호화 불가 |
| Fernet | Python cryptography symmetric encryption |