docs: add intraday data limitations to endpoint descriptions

GET /price/intraday (Yahoo Finance):
- 15분 지연, 1m=7일/5m-30m=60일/1h=730일 한계
- 백테스트 용도, 실시간 전략 부적합

GET /alpaca/intraday (Alpaca IEX):
- 실시간, IEX 피드 2~5% 커버리지
- 거래량 낮게 표시, 가격 레벨은 유사
- ORB 등 당일 실시간 전략 용도

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

app/api/v1/endpoints/alpaca.py

@@ -225,12 +225,23 @@ async def get_alpaca_price_data(
     response_model=AlpacaMultiBarsResponse,
     summary="Get intraday bars for multiple tickers via Alpaca (DB-backed)",
     description=(
-        "Fetch intraday OHLCV bars for up to ~500 tickers. Results are stored in DB "
-        "so subsequent calls for the same period skip Alpaca.\n\n"
+        "Fetch intraday OHLCV bars for up to ~500 tickers via Alpaca IEX feed. "
+        "Results are stored in DB so subsequent calls for the same period skip Alpaca.\n\n"
+        "**⚠️ Alpaca IEX 피드 분봉 데이터 한계**\n\n"
+        "| 항목 | 내용 |\n"
+        "|------|------|\n"
+        "| 피드 | **IEX 피드** (무료 플랜 기본값) |\n"
+        "| 지연 | **실시간** (지연 없음) |\n"
+        "| 거래량 커버리지 | 미국 전체 시장의 약 **2~5%** (IEX 거래소 거래만 집계) |\n"
+        "| OHLCV 정확도 | SIP 대비 **거래량 대폭 낮게** 표시됨 (가격 레벨은 유사) |\n"
+        "| 당일 장 중 재요청 | max_date < end_dt 조건으로 **항상 Alpaca 재호출** |\n"
+        "| SIP 피드 사용 시 | 유료 구독 + `feed=sip` 파라미터 추가 필요 |\n"
+        "| 히스토리 한계 | 과거 데이터는 SIP 기준이므로 무료 플랜 접근 범위 제한 없음 |\n\n"
+        "**권장 용도**: 당일 실시간 분봉 조회, ORB 전략 (가격 레벨 기준), 실시간 장 중 모니터링\n\n"
+        "**거래량 정확도가 중요하면** → 유료 Alpaca 플랜 + `feed=sip` 사용\n\n"
         "- `tickers`: comma-separated list, e.g. `AAPL,MSFT,BF-B`\n"
-        "- `interval`: `1m`, `5m`, `15m`, `30m`, `1h` (also accepts `5min`, `15min`, etc.)\n"
-        "- Ticker normalization: `BF-B` → `BF.B` handled automatically.\n"
-        "- During market hours, same-day requests always fetch from Alpaca (new bars forming).\n"
+        "- `interval`: `1m`, `5m`, `15m`, `30m`, `1h` (또는 `5min`, `15min` 등)\n"
+        "- DB 저장 후 재요청 시 Alpaca 미사용\n"
         "- Requires `ALPACA_API_KEY` / `ALPACA_SECRET_KEY`."
     ),
 )

app/api/v1/endpoints/price.py

@@ -657,10 +657,20 @@ async def get_quote(
     summary="Get intraday bars for multiple tickers via Yahoo Finance",
     description=(
         "Fetch intraday OHLCV bars for up to ~500 tickers using Yahoo Finance.\n\n"
+        "**⚠️ Yahoo Finance 분봉 데이터 한계**\n\n"
+        "| 항목 | 내용 |\n"
+        "|------|------|\n"
+        "| 지연 | **15분 지연** (실시간 아님) |\n"
+        "| `1m` 최대 조회 기간 | 최근 **7일** 이내 |\n"
+        "| `2m`/`5m`/`15m`/`30m`/`90m` | 최근 **60일** 이내 |\n"
+        "| `1h` | 최근 **730일** 이내 |\n"
+        "| 실시간 거래 전략 | **부적합** — 15분 지연으로 ORB 등 당일 전략에 사용 불가 |\n"
+        "| 데이터 품질 | Yahoo Finance 자체 집계, 간헐적 누락/오류 가능 |\n\n"
+        "**권장 용도**: 백테스트, 과거 분봉 분석 (60일 이내)\n\n"
+        "**실시간 당일 분봉이 필요하면** → `GET /api/v1/alpaca/intraday` 사용 (Alpaca IEX 피드, 실시간)\n\n"
         "- `tickers`: comma-separated, e.g. `AAPL,MSFT,BF-B`\n"
-        "- `interval`: `1m` (7 days), `5m`/`15m`/`30m` (60 days), `1h` (730 days)\n"
-        "- No subscription required — uses yfinance free data.\n"
-        "- **No DB cache** — Redis 5-min TTL for live data."
+        "- `interval`: `1m`, `5m`, `15m`, `30m`, `1h`\n"
+        "- Redis 5분 TTL 캐시 적용"
     ),
 )
 async def get_multi_ticker_intraday(