限流與資料時效
了解各方案的請求配額、快取更新頻率以及回應標頭中的時效指標。
限流與額度
- 每個 API Key 有每分鐘請求數上限，超出回傳 429，並在
Retry-After回應頭給出建議等待的秒數。 - 部分方案有每日請求數上限，按 UTC 日期計算，次日 0 點（UTC）重置。
- 每個回應都帶
X-RateLimit-Limit（每分鐘上限）與X-RateLimit-Remaining（剩余次數）。 - WebSocket 握手也計入請求數。
數據時效
為了穩定和限流，行情介面帶有快取，數據會比上游略有滯後。實時報價、成交、盤口由閘道按上游額度統一刷新：最快每 3 秒更新一次，同一時刻被請求的品種很多時更新間隔會變長，請以每個回應的 X-Data-Age 頭（數據年齡，秒）為准。其余數據的快取時間見下表，X-Proxy-TTL 頭給出實際值（秒）。
| 數據 | 預設快取時間 / 刷新間隔 |
|---|---|
| 實時報價、成交、盤口 | 最快 3 秒（閘道統一刷新） |
| 分鐘 K 線（含當前這根） | 30 秒 |
| 日、週、月 K 線（含當前這根） | 5 分鐘 |
帶 et 參數的歷史 K 線 | 1 小時 |
| 產品列表、假期、基本信息 | 24 小時 |
| 市场状態 | 30 秒 |
快取回應頭
| X-Proxy-Cache | 含義 |
|---|---|
HIT / L2-HIT | 命中快取 |
MISS | 本次從上游獲取 |
COALESCED | 與同時到達的相同請求合並，共用一次上游獲取 |
STALE | 上游暫時異常，回傳了最多 30 秒前的數據 |
BUSY | 上游調用額度暫時用儘，稍後重試（回傳 503） |
BYPASS | 該請求不快取 |
需要毫秒級延遲的高頻交易场景，請直連數據源或交易所，不要依賴帶快取的行情。