跳到主要内容
基金数据 API

接口文档

先看这里的通用约定(鉴权、信封、错误码、限流),再看具体端点。所有示例响应都取自线上实抓, 不是按代码推的。

鉴权

所有付费端点用 query 参数 key 鉴权:

GET https://api.fundapi.cn/v1/fund-nav?code=110022&key=你的Key
  • 推荐请求头 Authorization: Bearer 你的Key —— 密钥不进 URL 与访问日志。URL 上加 ?key= 也支持,仅建议浏览器里快速试。⛔ 不支持 X-API-Key。
  • API Key 只在签发时明文显示一次。
  • code 一律是 6 位场外基金代码(如 110022)。传股票代码会返回「查询不到」。
  • 健康检查 GET /health 不需要 API Key,也不消耗额度,可以直接接进监控。

响应信封

所有端点返回同一形状,不会有第二种格式:

{
  "ok": true,
  "endpoint": "fund-nav",
  "tier": "pro",
  "elapsed_ms": 426,
  "data": { }
}
  • ok:true 成功;false 失败,此时 data 为 null,看 error。
  • tier:本次请求使用的版本。
  • elapsed_ms:服务端耗时(毫秒)。

⚠️ 业务失败也是 HTTP 200(ok:false)。 所以判断成功要先看 ok,不能只看状态码。

错误码

HTTP场景error 示例
200 + ok:false代码查不到 / 数据源临时不可用查询不到对应数据
401没带 API Key,或者填错了需要 API Key
403版本不够 / UA 被判为扫描器此端点需更高版本,如「此端点需专业版及以上」 / 请求被安全策略拦截
404端点路径不存在端点不存在:/v1/fund-nope
405用了非 GET 方法该端点不支持这种请求方法
422缺参数 / 参数格式错缺少或不合法的参数:code
429超限流 / 超日额度 / 并发超限见响应头 Retry-After

限流与并发

层级限制说明
单 IP 并发连接8 条超了返回 429,连接关掉重试即可
不填 key(匿名)每天 500 次 / 每分钟 10 次按 IP 计,只能调 3 个免费端点
体验版不限日额度 / 每分钟 30 次按 API Key 计,7 天
专业版不限日额度 / 每分钟 60 次按 API Key 计
机构版不限日额度 / 每分钟 300 次按 API Key 计
  • 并发 8 条对批量场景够用 —— 一个请求能拿几十上百条,⛔ 不要「一只一个请求」去并发轰。
  • 超限返回 429 并带 Retry-After,按它等待即可。
  • 请求必须带 User-Agent。空 UA 或 UA 里出现扫描器特征会被直接 403。

两个特殊标记

标记含义
stale: true + stale_age_s拿到数据了,但不是最新的(旧了 N 秒)。数据源故障时才会出现
degraded: true + reason什么都没拿到,稍后重试

两者互斥。stale 不代表数据错误,只代表「晚了一点」。 盘中估值端点永远不返回 stale —— 给旧值比报错更误导。

全部端点

端点名称版本
/v1/fund-search基金搜索免费
/v1/fund-profile基金档案免费
/v1/fund-screener-options筛选项字典免费
/v1/fund-nav历史净值体验版
/v1/fund-rank全市场排行体验版
/v1/fund-notices基金公告体验版
/v1/fund-holdings季报持仓专业版
/v1/fund-managers基金经理专业版
/v1/fund-estimate盘中估值专业版
/v1/fund-dividends分红送配专业版
/v1/fund-trade-rule交易规则专业版
/v1/fund-rating机构评级专业版
/v1/fund-overlap持仓重叠机构版
/v1/fund-portfolio-xray组合穿透机构版
/v1/fund-portfolio-diagnose组合诊断机构版
/v1/fund-holding-changes持仓变动机构版
/v1/fund-manager-history经理变更史机构版
/v1/fund-compare基金对比机构版
/v1/fund-screener全市场筛选机构版