跳到主要内容
基金数据 API

常见问题

按「数据说明 / 接口使用 / 服务与边界」分组。都是接入时会真遇到的问题,不是 FAQ 凑数。

数据说明

覆盖哪些基金?以后会加 ETF / QDII 吗?+

当前覆盖场外公募基金(含货币基金)。ETF / LOF 等场内品种、QDII 等在规划中;新增品种会以新端点提供,现有工具名与调用方式不变。

净值多久更新一次?是不是实时的?+

不是实时。场外基金净值由基金公司在交易日收盘后计算并发布,我们的净值在当晚更新,所以盘中刷新看不到当日净值。要做盘中涨跌判断请用盘中估值端点(机构版),那是估算值、⛔ 不是净值。

为什么传 600519 查不到?+

这是场外基金接口,只认 6 位场外基金代码(如 110022)。600519 是股票代码,会返回「查询不到对应数据」。股票数据在另一个产品线,不是这里。

季报持仓是什么时点的?能反映当前仓位吗?+

不能。持仓来自基金季报,报告期结束后才披露,示例中的报告期是 2026年3季度。它永远是过去时 —— 拿它当「现在买了什么」会判错。要看最近的仓位变化趋势,用持仓变动端点(机构版)。

评级字段返回 null,是 0 星还是取数失败?+

都不是。null 表示该机构当期没有对这只基金评级。实测有不少基金只有部分机构有值,另外几家长期为 null。⛔ 不要把 null 当低分,也不要据此判断基金好坏。

债基 / 货基为什么没有盘中估值?+

它们没有股票仓位,盘中估值模型没有输入,所以两种估算都没有数据。此时返回 ok:true + has_estimate:false + reason,这是正常结果,不是故障。

stale 和 degraded 有什么区别?+

stale 是「拿到数据了,但不是最新的」,会带 stale_age_s 说明旧了多少秒 —— 数据源故障时的兜底,不代表数据错误。degraded 是「什么都没拿到」,稍后重试。两者互斥。

收益率的时段为什么是 1w / 1m / 1y 这种键名?+

1w = 近1周、1m = 近1月、1y = 近1年,另有 3m / 6m / 2y / 3y / 5y / ytd(今年来)/ since(成立来)。注意「成立来」没有同类平均、沪深300 与排名,这三个字段返回空字符串而不是 0。

接口使用

API Key 怎么传?放 header 还是 query?+

推荐用请求头 Authorization: Bearer 你的Key —— 密钥不会出现在 URL、访问日志或浏览器历史里。URL 上加 ?key= 也支持,仅建议在浏览器里快速试。不支持 X-API-Key。

返回 200 但 ok 是 false,是接口坏了吗?+

不是。业务失败(代码查不到、数据源临时不可用)走 HTTP 200 + ok:false,只有鉴权、参数、路径、限流才用非 200 状态码。判断成功要先看 ok 字段。

一次能拿多少条历史净值?+

每页 1–50 条,按 page 翻页。110022 实测有 3923 个净值日,按 50 条一页需要 79 页。建议按需取区间,不要一次拉全量。

返回 429 怎么办?会被封吗?+

按响应头 Retry-After 等待后重试即可,不会扣费也不会封禁。触发原因有三种:每分钟频率超了、单 IP 并发超过 8 条、当日额度用完(不填 key 是 500 次/天)。

接口响应一般多快?+

大多数端点 0.3–1.1 秒;组合诊断、多基金对比、盘中估值首次约 2–3 秒,之后走缓存基本在 1 秒内。建议客户端超时设 10 秒以上。

能不能并发批量查几百只基金?+

可以,但单 IP 并发上限是 8 条,超过会 429。正确做法是压到 8 条以内做流水线,或者用已经支持多标的的端点(如组合穿透、基金对比)一次拿多只。

服务与边界

能不能导出一份全市场基金数据集给我?+

不提供数据集导出。我们卖的是接口调用能力,不是数据文件 —— 需要全市场横截面请用全市场筛选端点分页取(单页上限 200 条)。

数据从哪来?准不准?+

数据来自基金公司与代销平台的公开披露。除单位换算外,接口返回的数值与来源保持一致;涨跌幅这类派生量,由你按自己的需要计算。

接口挂了怎么知道?+

GET /health 不需要 API Key、不消耗额度,可以直接接进你的监控。它返回服务名与版本号。注意触发来源限制时它也会返回 429 —— 防护对所有端点一致,不给探活留后门。

你们提供投资建议吗?+

不提供。我们是数据接口,只负责把披露数据整理成结构化 JSON。评分、评级、排名都是评级机构自己的方法与历史值,不构成任何投资建议。基金有风险,投资需谨慎。

没找到答案?先看 接口文档, 或 扫码咨询。