주식 (Equity)
US/KR Equity와 Crypto 자산을 분석·백테스트·페이퍼 트레이딩하는 통합 화면입니다. 4개 탭으로 구성되며, 헤더 우측에 자산군 필터(All/US/KR/Crypto)를 추가로 갖습니다.
📸 Equity 페이지 4탭 레이아웃 (추후 자동 캡처 예정)
4개 탭
| 탭 | 아이콘 | 역할 |
|---|---|---|
| Watchlist | Eye | 관심 종목 목록 + 실시간 시세 + Analyze 트리거 |
| Reports | FileSearch | LLM 기반 분석 보고서 생성 / 조회 |
| Backtest | FlaskConical | 자산군/심볼/기간/전략 선택 후 백테스트 실행 |
| Trade | Zap | OrderTicket + Open orders + Positions + Account |
탭 상태는 useEquityStore (Zustand)에서 관리되며, 페이지 새로고침 시에도 활성 탭이 유지됩니다.
자식 페이지
자산군 필터 (All / US / KR / Crypto)
대시보드와 동일한 디자인이지만, Equity 페이지에서는 4개 탭이 모두 이 필터를 따릅니다.
| 필터 | Watchlist | Reports | Backtest | Trade |
|---|---|---|---|---|
| All | 3개 자산군 모두 | 모든 보고서 | US 기본 | Trade tab의 Account select와 별개 |
| US | US만 | US 보고서만 | us_equity | US Equity 라우팅 |
| KR | KR만 | KR 보고서만 | kr_equity | KR Equity 라우팅 |
| Crypto | Crypto만 | Crypto 보고서만 | n/a | n/a |
API 연동
| Method | Path | 호출 위치 |
|---|---|---|
| GET | /api/equity/symbols/search | SymbolSearch 컴포넌트 (실시간 자동완성) |
| POST | /api/equity/analyze | Watchlist Analyze 버튼 + Reports 폼 |
| GET | /api/equity/reports | Reports 탭 리스트 |
| GET | /api/equity/reports/{uuid} | ReportDrawer |
| GET | /api/equity/reports/{uuid}/traces | ReportDrawer agent traces |
| POST | /api/equity/backtest | Backtest 탭 |
| POST | /api/equity/orders | Trade 탭 OrderTicket |
| GET | /api/equity/orders | Trade 탭 open orders |
| DELETE | /api/equity/orders/{id} | Cancel 버튼 |
| GET | /api/equity/positions | Trade 탭 positions table |
| GET | /api/equity/account | Trade 탭 Account 카드 |
자세한 스펙은 다음 API 레퍼런스를 참고하세요.
- /api-reference/equity-analyze
- /api-reference/equity-orders
- /api-reference/equity-backtest
- /api-reference/equity-live
절대 룰
페이퍼 우선
Trade 탭의 OrderTicket은 기본적으로 paper 모드로만 동작합니다. Live 활성은 /api-reference/equity-live의 request_confirm → enable 흐름을 거쳐야 하며, 자산군별 readiness 검증(3개월 paper 거래 + drawdown 한도)을 통과해야 합니다.
자주 묻는 질문
Q. 어떤 자산군부터 시작해야 하나요?
A. paper 키 발급이 가장 쉬운 Alpaca(US)로 시작하길 권장합니다. Settings → Alpaca 참고.
Q. Watchlist 데이터는 어디에 저장되나요?
A. 현재 브라우저 localStorage에 사용자별로 저장됩니다 (Zustand persist).