3 步拿到数据
快速开始
不需要 SDK、不需要申请流程。一个 curl 就能拿到真实数据。
1拿到 Key
免费端点无需 Key 即可试。要全量能力 → 获取 Key(见定价)。
# 免费端点直接调(无需 Key)
curl "https://api.ashareapi.com/v1/quote?code=sh600667"2带上 Key 调接口
二选一:Authorization 头(推荐,不泄露在日志里)或 URL 参数 ?key=
# 方式 A:请求头(推荐)
curl -H "Authorization: Bearer ct-你的KEY" \
"https://api.ashareapi.com/v1/fund?code=sh600667"
# 方式 B:URL 参数(浏览器里方便)
curl "https://api.ashareapi.com/v1/fund?code=sh600667&key=ct-你的KEY"3看返回
统一 JSON 信封:ok / endpoint / tier / elapsed_ms / source / data
{
"ok": true,
"endpoint": "fund",
"tier": "pro",
"elapsed_ms": 862,
"source": "腾讯自选股官方通道",
"data": { "main_net": "...", "lhb": [...], ... }
}错误码
出错时先看这张表 —— 大部分问题能自己解决。
| 码 | 含义 | 怎么办 |
|---|---|---|
| 401 | API Key 无效 | Key 拼错 / 已禁用 → 检查 Key;或未带 Key 调了付费端点 |
| 403 | 本 Key 今日已用过 N 个不同 IP | 触发 IP 维度反倒卖 → 换网络被误拦请联系我们重置 |
| 429 | 超出频率限制(每分钟) | 降频或加间隔;Pro 是 120 次/分 |
| 200 + ok:false | 上游取数失败 | 已自动切备胎;若持续请反馈(附 endpoint 与时间) |
接入指引
想看完整端点?
28 个端点的参数与 curl / Python / JS 示例,一页看全。