Provider 헬스체크
quant-ai는 다음 데이터 프로바이더와 broker를 사용합니다. 각 프로바이더의 가용성을 확인하는 위젯이 Data 페이지 또는 운영 페이지에 노출됩니다.
📸 Provider 헬스 카드 (추후 자동 캡처 예정)
프로바이더 카탈로그
| 프로바이더 | 자산군 | 용도 |
|---|---|---|
| Binance / Bybit / OKX | crypto | OHLCV + 주문 |
| Alpaca | us_equity | OHLCV + 주문 (paper) |
| KIS (한국투자증권) | kr_equity | OHLCV + 주문 (모의) |
| yfinance | us_equity / kr_equity | 백업 OHLCV |
| News Provider (Guardian/CryptoBERT) | all | 뉴스 sentiment |
헬스 상태
| 상태 | 의미 |
|---|---|
| healthy (emerald) | 최근 1분 내 정상 응답 |
| degraded (amber) | 응답 5xx 또는 latency p95 > 2s |
| down (rose) | 30초 이상 응답 없음 |
| disabled (zinc) | 키 미등록 또는 ENV에서 비활성 |
API 호출 (현행)
전용 헬스 엔드포인트는 후속 작업이며, 현재는 다음 간접 방식으로 확인합니다.
# 프로바이더 status는 /health 엔드포인트와 broker.test_connection으로 추정
curl -s http://localhost:8000/health
응답:
{
"status": "ok",
"providers": {
"alpaca_paper": "healthy",
"kis_mock": "healthy",
"binance_spot": "healthy",
"yfinance": "degraded"
}
}
운영 가이드
각 프로바이더 장애 대응:
| 프로바이더 | 일반 장애 | 조치 |
|---|---|---|
| Alpaca | 401 | API key 재발급 또는 base_url 확인 |
| KIS | 401 / 토큰 만료 | KIS 토큰 만료 |
| Binance | 429 (rate limit) | weight 사용량 확인, request 간격 늘림 |
| yfinance | 5xx | retry + 1차 fallback (Alpaca/KIS) |
자주 묻는 질문
Q. yfinance가 degraded로 자주 떠요.
A. 비공식 API라 안정성이 낮습니다. 백업 용도로만 사용하고, 1차는 정식 broker(Alpaca/KIS)를 권장합니다.
Q. KIS는 야간에 항상 down으로 보입니다.
A. KIS는 19:00–07:00 KST 정기 점검 시간이 있습니다. 정상 동작입니다.
Q. provider별 latency 그래프는 어디서?
A. Grafana dashboards의 "Data providers" 패널 참고.