接口文档
先看这里的通用约定(鉴权、信封、错误码、限流),再看具体端点。所有示例响应都取自线上实抓, 不是按代码推的。
鉴权
所有付费端点用 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 | 全市场筛选 | 机构版 |