适用场景在日常的金融投资与数据监控中基金估值跟踪是一个高频需求。该 API 主要适用以下四种典型场景基金组合实时监控投资者持有多个基金时需要快速获取盘中估算净值与涨跌幅辅助决策。指数行情看板构建简单的 A 股核心指数如上证、深证成指、创业板、上证 50、沪深 300、中证 500实时点位看板。基金详情入库开发基金分析工具时需要批量获取基金历史收益近 1 月/3 月/6 月/1 年等、管理人、规模等元数据。量化策略回测辅助获取准确的历史净值日期与当前估算数据用于策略信号的计算。接口能力边界本接口聚合了四种独立的操作类型action开发者可根据需求单次调用无需对接多个上游数据源。操作类型action 值功能说明数据来源更新频率基金实时估值estimate返回指定基金代码的估算净值、单位净值、估算涨跌幅、上次净值日期天天基金、新浪财经、东方财富盘中每分钟更新约 9:30–15:00单个指数行情index返回指数当前点位、涨跌点数、涨跌幅新浪主通道、东方财富备通道双容错实时调用获取最新基金详细信息info返回基金名称、净值、累计净值、各区间收益、类型、风险等级、规模、基金经理、成立日、管理人同上基金净值日更新后可用常用指数批量indices一次性返回上证、深证成指、创业板、上证 50、沪深 300、中证 500 共 6 个指数的行情同上实时能力边界要点QPS 上限为 5 次/秒超出限流会返回错误。数据来源为公开爬取非官方直连但已修复“新浪通道缺 sh/sz 前缀”的 bug 并增强了 HTML 解析容错。仅支持国内公募基金与 A 股核心指数不包含海外指数或场内 ETF 实时行情。估算数据仅供参考与最终官方净值可能存在偏差。请求参数与鉴权Query 参数参数名必填类型说明示例action是string操作类型estimate/index/info/indicesestimatecode条件必填string基金或指数代码6 位数字当 action 为estimate/index/info时必须提供indices时忽略005827Header 参数可选参数名必填类型说明示例Authorization否stringAPI Key 鉴权头格式Bearer sk_live_xxx匿名调用时可省略每日 50 次调用次数限制Bearer sk_live_xxxxxxxxxxxxxx注意如果使用匿名调用无需传入 Header但每日有 50 次请求限制。建议在生产环境中使用 API Key 以便获得更高配额与稳定服务。curl 接入示例以下示例演示如何获取基金005827的实时估值# 使用环境变量存储 API Key推荐exportAPIZERO_KEYsk_live_xxxxxxxxxxxxxxcurl-sS\-XGET\-HAuthorization: Bearer$APIZERO_KEY\https://v1.apizero.cn/api/fund?actionestimatecode005827若使用匿名调用则直接请求curl-sS-XGEThttps://v1.apizero.cn/api/fund?actionestimatecode005827其他 action 示例获取单个指数行情以上证指数000001为例curl-sS-XGEThttps://v1.apizero.cn/api/fund?actionindexcode000001获取基金详情curl-sS-XGEThttps://v1.apizero.cn/api/fund?actioninfocode005827批量获取常用指数curl-sS-XGEThttps://v1.apizero.cn/api/fund?actionindices返回值解读所有 action 统一返回 JSON 对象顶层字段如下{code:0,data:{...},msg:成功,request_id:abc123def456}code0 表示成功非 0 表示错误。msg状态描述。request_id唯一请求 ID可用于排查问题。data根据不同 action 返回不同结构。actionestimate 返回的 data 字段字段类型说明actionstring固定为estimatefund_codestring基金代码fund_namestring基金名称net_valuenumber最新单位净值estimatenumber估算净值盘中change_ratenumber估算涨跌幅百分比如 -0.71 表示 -0.71%nav_datestring单位净值日期格式 YYYY-MM-DDupdate_timestring数据更新时间格式 YYYY-MM-DD HH:mmactionindex 返回的 data 字段字段类型说明actionstring固定为indexindex_codestring指数代码index_namestring指数名称current_pointnumber当前点位change_pointnumber涨跌点数change_ratenumber涨跌幅百分比update_timestring数据时间actioninfo 返回的 data 字段字段类型说明actionstring固定为infofund_codestring基金代码fund_namestring基金名称net_valuenumber最新单位净值accumulated_net_valuenumber累计净值fund_typestring基金类型如股票型、混合型risk_levelstring风险等级如 R3fund_sizestring基金规模如 “150.20亿元”fund_managerstring基金经理establishment_datestring成立日期managerstring管理人return_1mnumber近 1 月收益率百分比return_3mnumber近 3 月收益率return_6mnumber近 6 月收益率return_1ynumber近 1 年收益率return_3ynumber近 3 年收益率return_since_inceptionnumber成立以来收益率actionindices 返回的 data 字段data是一个数组每个元素包含指数行情同 index 的 data 结构顺序为上证、深证成指、创业板指、上证 50、沪深 300、中证 500。示例{code:0,data:[{index_code:000001,index_name:上证指数,current_point:3123.45,...},{index_code:399001,index_name:深证成指,...},...// 共 6 项],msg:成功,request_id:req789}常见错误与处理codemsg原因处理建议1001参数缺失action、code 未提供或格式错误检查请求参数是否完整1002无效的基金/指数代码code 不存在或不能匹配确认代码是否正确仅支持 6 位数字1003数据源异常上游数据暂时不可用稍后重试建议增加指数退避429请求过多超出 QPS 5/s 限制降低请求频率或升级 API Key 配额401鉴权失败Authorization 头格式错误或 Key 无效检查 Bearer 前缀及 Key 是否正确工程化注意事项1. 缓存策略基金估值盘中每分钟更新建议客户端缓存 30–60 秒避免频繁调用导致限流。基金详情数据变化频率低通常每日一次可缓存数小时甚至一天。指数行情实时性要求高但同样可设置 10–30 秒缓存。2. 错误重试网络异常或服务端返回 5xx 时推荐使用指数退避重试如 1s、2s、4s 后重试最多 3 次。对于 429 限流错误应等待至少 1 秒后再请求。3. 并发控制QPS 为 5/s若使用异步框架需内置令牌桶或请求队列防止瞬时打满。多 action 可并行请求但要控制总并发数不超过 5。4. 数据校正估算净值与最终官方净值可能存在偏差切勿用于自动交易决策。净值日期字段nav_date应与 update_time 区分避免用估算值代替实际净值。5. 代码示例Pythonimportrequestsimporttime API_BASEhttps://v1.apizero.cn/api/fundAPI_KEYsk_live_xxxxxxxxxxxxxxdefget_fund_estimate(fund_code):headers{Authorization:fBearer{API_KEY}}params{action:estimate,code:fund_code}resprequests.get(API_BASE,headersheaders,paramsparams)dataresp.json()ifdata[code]0:returndata[data]else:raiseException(fRequest failed:{data[msg]})# 使用示例dataget_fund_estimate(005827)print(f基金{data[fund_name]}估算净值{data[estimate]}涨跌幅{data[change_rate]}%)