出错先看这里
错误码
大部分问题能自己解决。解决不了的，把 endpoint + code + 时间发我们。
401API Key 无效可能原因
- Key 拼写错误（注意大小写，形如 ct-xxxxxxxx）
- Key 已被禁用（转卖判定 / 手动停用）
- 没带 Key 却调了付费端点
- Key 传给 URL 参数时漏了 ?key= 或 &key=
怎么办
核对 Key；免费端点（quote / kline / hot / market-overview / changedist / health）无需 Key
403本 Key 今日已用过 N 个不同 IP（超出上限）可能原因
- 一个 Key 被多人共用（转卖）
- 正常使用但换了网络（出差 / 手机热点 / 动态 IP / 代理）
- 同一局域网出口 IP 变化（少见）
怎么办
正常使用被误拦 → 联系客服重置；共用请各自购买
429超出频率限制（每分钟调用数）可能原因
- 短时间并发过高
- 循环里没加间隔
怎么办
加 sleep 或降并发。Free 10 次/分 · Pro 120 次/分 · Enterprise 600 次/分
200 + ok:false上游取数失败（data 为空）可能原因
- 上游数据源临时挂了
- 代码传了不存在的股票代码
- 上游接口改版
怎么办
多源会自动切换；若持续失败，把 endpoint + code + 时间发我们
422参数格式错误可能原因
- code 没带市场前缀（应 sh600667 而非 600667）
- 日期格式不对（应 YYYY-MM-DD）
- required 参数缺失
怎么办
对照端点清单的参数表
参数约定
| code 带市场前缀 | sh600667（沪）· sz000001（深）· hk00700（港）· usAAPL（美）· sh113052（沪转债）· sz123138（深转债） |
| 日期格式 | YYYY-MM-DD（如 2026-09-16）；留空 = 最近交易日 |
| 布尔值 | true / false（小写） |
| 返回信封 | 统一 { ok, endpoint, tier, elapsed_ms, source, data } |
自助排查顺序
1先看状态码 —— 对照本页
2再确认参数 —— 对照端点清单的参数表（code 有没有前缀？日期格式对不对？）
3用免费端点验证 Key 链路 —— /v1/quote?code=sh600667
4最后才找我们 —— 附上完整请求 URL（Key 打码）+ 返回内容 + 时间