适用场景在金融数据应用开发中基金与指数行情的实时性、准确性和接口聚合度直接决定了用户体验与后端复杂度。基金估值跟踪 API 将四类高频需求封装为单一入口盘中实时基金净值推算、A 股核心指数行情追踪、基金档案详情查询以及常用指数批量采集。无论你是构建个人投资看板、基金组合监控系统还是资讯类 App 的行情模块都能从中找到对应的调用策略。接口能力边界与选型分析API 提供四个 action每个 action 对应一个数据子集其数据源、更新频率、必填参数与批量能力各不相同。理解这些边界是正确选型的前提。1. actionestimate — 基金实时估值能力边界返回单只基金的最新单位净值、估算净值、估算涨跌幅及上次净值日期。数据源于天天基金与东方财富的盘中实时估算每分钟更新一次。估算值通常与最终公布的净值偏差在 0.1% ~ 0.5% 之间但在极端行情或分红除权日可能误差更大。适用场景适合需要在交易时间段内展示“预估涨跌”的界面如基金组合实时盈亏监控、盘中预警触发器。注意该 action不支持批量每请求仅返回一只基金的数据若需同时追踪数十只基金需循环调用并遵守 QPS 限制。2. actionindex — 单个指数行情能力边界查询单个 A 股核心指数的当前点位、涨跌点数与涨跌幅。采用新浪财经为主通道、东方财富为备通道的双路容灾机制当主通道超时或返回异常时自动切换开发者无需额外处理。数据为实时更新盘中每数秒刷新。适用场景适合单独展示某一指数如上证指数、沪深 300的详细行情。接口已修复部分第三方实现中sh/sz前缀缺失导致的查询失败问题直接传入 6 位指数代码即可如000001代表上证指数。3. actioninfo — 基金详细信息能力边界返回基金全称、最新单位净值、累计净值、近 1 月 / 3 月 / 6 月 / 1 年 / 3 年 / 成立以来收益率、基金类型股票型、混合型等、风险等级、资产规模、基金经理、成立日期及管理人。数据由上游基金网站整理通常为日级更新每个交易日收盘后不具备盘中实时性。适用场景适用于基金详情页、基金筛选比较等非实时场景。由于数据变化频率低最多一天一次强烈建议在客户端或中间层设置合理缓存策略避免重复拉取。4. actionindices — 常用指数批量能力边界无需传入 code 参数一次请求即返回上证指数、深证成指、创业板指、上证 50、沪深 300、中证 500 共 6 个核心指数的名称、最新点位及涨跌幅。数据源与 actionindex 相同同样具备双通道容灾。适用场景最适合 App 首页的“大盘指数”模块、行情概览页面。无法自定义指数列表仅固定六只。若你需要追踪其他指数请使用 actionindex 逐只请求。请求参数与鉴权说明接口统一为GET https://v1.apizero.cn/api/fund通过 query 参数区分动作。参数类型必填说明actionstring是取值estimate/index/info/indicescodestring条件必填action 不为indices时必须传入6 位数字基金或指数代码Authorizationstring否鉴权头格式Bearer sk_live_xxx匿名调用时省略但有每日 50 次次数限制鉴权说明接口支持匿名调用每日有限额也可通过 HTTP HeaderAuthorization: Bearer your_api_key进行认证认证后无匿名次数限制但 QPS 仍为 5/s。快速上手curl 示例以下示例查询基金005827易方达蓝筹精选混合的实时估值。请将$APIZERO_API_KEY替换为你自己的密钥或省略-H行进行匿名调试。curl -sS \ -X GET \ -H Authorization: Bearer $APIZERO_API_KEY \ https://v1.apizero.cn/api/fund?actionestimatecode005827若使用匿名调用直接执行curl -sS \ -X GET \ https://v1.apizero.cn/api/fund?actionindexcode000001第一个示例返回实时估值第二个示例返回上证指数行情。响应均为 JSON 格式。返回值字段解读无论何种 action响应均包含顶层字段code、msg、request_id和data。code0表示成功code!0时msg会给出简要错误原因。actionestimate 的 data 字段字段类型说明actionstring固定estimatefund_codestring基金代码fund_namestring基金名称net_valuefloat最新单位净值estimatefloat盘中估算净值change_ratefloat估算涨跌幅百分比数值如 -0.71 表示 -0.71%nav_datestring上次净值日期格式YYYY-MM-DDupdate_timestring本次估算时间如2026-05-06 15:00actionindex 的 data 字段示例以文档为准字段类型说明actionstringindexnamestring指数名称pointfloat当前点位changefloat涨跌点数change_ratefloat涨跌幅百分比update_timestring更新时间actioninfo 的 data 字段部分字段类型说明actionstringinfofund_namestring基金全称net_valuefloat单位净值cumulative_valuefloat累计净值return_1mfloat?近 1 月收益率未返回时为 nullreturn_3mfloat?近 3 月收益率return_6mfloat?近 6 月收益率return_1yfloat?近 1 年收益率return_3yfloat?近 3 年收益率return_since_inceptionfloat?成立以来收益率fund_typestring基金类型risk_levelstring风险等级fund_sizefloat资产规模亿元managerstring基金经理inception_datestring成立日期management_companystring管理人actionindices 的 data 字段data 为一个数组每个元素包含name、point、change、change_rate等字段对应六只指数。顺序固定但不建议依赖顺序应通过name字段匹配。常见调用错误与处理方法HTTP 状态码常见原因处理建议400缺少 action 或 code 参数不合法检查请求参数action 必填code 在非 indices 时必填且为 6 位数字401Authorization 头格式错误或密钥无效确认密钥是否有效格式为Bearer sk_live_xxx429单位时间内请求超过 QPS 限制5/s降低请求频率加入限速队列或增加请求间隔至少 200ms503上游数据源临时不可用实施指数退避重试如 1s、2s、4s另外业务层应检查code字段若code ! 0依据msg判断是参数错误、数据不存在还是上游异常。例如code1可能表示“基金代码未找到”或“输入参数无效”。工程化注意事项QPS 管理接口 QPS 上限为 5/s即每秒最多 5 次请求。若需要同时追踪多只基金估值建议使用异步并发控制或定时任务间隔 200ms 以上发起请求。缓存策略actioninfo的数据按日更新缓存 TTL 可设为 4 小时或每天收盘后主动刷新。actionestimate每分钟更新缓存 TTL 建议 30~60 秒。actionindex和indices可按需缩短缓存如 10 秒。错误重试对于 503 或code非零的临时错误应采用指数退避重试例如第 1 次等待 1s第 2 次 2s最多 3 次。注意区分永久性错误如 400、401和临时性错误。环境变量管理不要在代码中硬编码 API Key应通过环境变量注入如APIZERO_API_KEY并在 curl 或代码中引用。超时设置建议设置 HTTP 连接超时 5s、读取超时 10s避免因上游响应缓慢阻塞线程池。指数容灾接口内部已实现主备通道自动切换开发者无感无需额外处理。参考文档接口文档基金估值跟踪原始文档raw.md