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": [...], ... }
}

错误码

出错时先看这张表 —— 大部分问题能自己解决。

含义怎么办
401API Key 无效Key 拼错 / 已禁用 → 检查 Key;或未带 Key 调了付费端点
403本 Key 今日已用过 N 个不同 IP触发 IP 维度反倒卖 → 换网络被误拦请联系我们重置
429超出频率限制(每分钟)降频或加间隔;Pro 是 120 次/分
200 + ok:false上游取数失败已自动切备胎;若持续请反馈(附 endpoint 与时间)

接入指引

接进 AI(MCP)

一条配置让 Claude / Cursor 直接查 A 股

查看
Python 调用

示例代码见端点清单

查看
多源容灾说明

主源挂了怎么自动切

查看
想看完整端点?

28 个端点的参数与 curl / Python / JS 示例,一页看全。

端点清单