限流与数据时效
了解每个令牌的额度，以及行情数据比上游滞后多少。
限流与额度
- 每个 API Key 有每分钟请求数上限，超出返回 429，并在
Retry-After响应头给出建议等待的秒数。 - 部分套餐有每日请求数上限，按 UTC 日期计算，次日 0 点（UTC）重置。
- 每个响应都带
X-RateLimit-Limit（每分钟上限）与X-RateLimit-Remaining（剩余次数）。 - WebSocket 握手也计入请求数。
数据时效
为了稳定和限流，行情接口带有短时缓存，数据会比上游略有滞后。下面是默认缓存时间，每个响应的 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 | 该请求不缓存 |
需要毫秒级延迟的高频交易场景，请直连数据源或交易所，不要依赖带缓存的行情。