开放式基金盘中净值估算 - 咕咕数据 API 文档

盘中估算净值、涨跌率与估算偏差
接口标签：开放式基金、盘中估值、估算偏差、净值估算、盘中数据
接口特性：

返回盘中估算净值和估算涨跌率，用于交易时段内观察开放式基金参考走势
同时返回最近公布的官方单位净值、官方日增长率和前一净值日单位净值
EstimatedDeviation 表示估算值与最近官方净值之间的偏差，便于比较估算结果
symbol 可传一个代码，也可使用英文逗号分隔最多 50 个 6 位基金代码
传入 symbol 时优先按基金代码筛选；未传 symbol 时可使用 type 按基金类型筛选
type 和 symbol 均可省略，type 空值会按“全部”处理并返回当前可用结果
非交易时段、基金未被覆盖或数据尚未更新时，可能返回空列表及明确状态说明
估算结果仅供盘中参考，不等同于基金公司最终公布净值，也不代表可成交价格
详情页：https://www.gugudata.com/api/details/fundvalueestimation

当前接口契约

接口详情：https://www.gugudata.com/api/details/fundvalueestimation

功能说明

传入 symbol 时按基金代码筛选并核验当前可用估算结果；未传 symbol 时可使用 type 按基金类型筛选；
盘中估算不可用时将最近官方净值和日增长率兼容回填至原估算字段，并通过状态字段明确区分数据来源；

请求参数

参数	类型	必填	默认值	说明
appkey	string	是	无	必填。接口调用凭证，请在咕咕数据控制台获取；用于身份鉴权和套餐额度校验，不要在公开页面或客户端日志中暴露
type	string	否	全部	可选。基金类型筛选值，默认“全部”；空字符串同样按“全部”处理。传入 symbol 后优先按基金代码筛选
symbol	string	否	无	可选。传单个 6 位开放式基金代码，或使用英文逗号分隔多个代码，最多 50 个；代码会去重并保留前导零

正常响应字段

字段	类型	说明
Data	array	基金记录数组；每条记录的字段按当前查询指标返回。
DataStatus.RequestParameter	string	本次实际业务请求参数，不包含鉴权凭据；Demo 展示对应样例输入。
DataStatus.StatusCode	integer	业务状态码；100 表示正常返回，其他值需结合 StatusDescription 判断
DataStatus.StatusDescription	string	业务状态说明；成功时说明请求结果，失败时说明参数、权限或数据依赖问题
DataStatus.ResponseDateTime	string	服务端生成响应的北京时间，格式为 yyyy-MM-dd HH:mm:ss.fff
DataStatus.DataTotalCount	integer	当前查询条件下的数据总量；分页接口通常表示全部匹配数量，而不是当前页条数
Data[].FundCode	string	当前估算记录所属基金的 6 位代码，保留前导零
Data[].FundName	string	基金名称，用于确认代码对应的开放式基金产品
Data[].FundType	string	基金所属类型，可用于结果分组和筛选
Data[].EstimatedValue	number	IsEstimated=true 时为盘中估算净值；IsEstimated=false 时为兼容原接入逻辑而回填的最近官方单位净值
Data[].EstimatedGrowthRate	number	IsEstimated=true 时为盘中估算涨跌率；IsEstimated=false 时回填最近官方净值对应的日增长率，单位为百分比
Data[].EstimatedGrowthReferenceValue	number	根据当前估算值及估算涨跌率反算的参考净值；分红除息日可能与 NetAssetValueYesterday 不同
Data[].NetAssetValue	number	基金公司最近一次公布的官方单位净值，用作估算结果对照
Data[].DailyGrowthRate	number	最近官方单位净值对应的日增长率，单位为百分比
Data[].EstimatedDeviation	number	盘中估算净值与最近官方单位净值之间的数据源偏差值
Data[].NetAssetValueYesterday	number	前一个已公布净值日的官方单位净值
Data[].SnapshotTime	string	当前记录的更新时间；官方净值兜底时为对应净值日期
Data[].IsEstimated	boolean	是否包含真实盘中估算值；false 时仅返回最近公布的官方净值参考
Data[].EstimateStatus	string	估算状态。AVAILABLE 表示盘中估算可用；UNAVAILABLE 表示当前无可用盘中估算
Data[].EstimateMethod	string	数据来源。UPSTREAM_REALTIME 表示盘中估算；LATEST_OFFICIAL_NAV 表示最近官方净值兜底
Data[].ReferenceNAVDate	string	盘中估算采用的官方净值基准日期，格式为 yyyy-MM-dd
Data[].DataScope	string	兼容保留字段，当前固定返回空字符串
Data[].NoDataReason	string	兼容保留字段，当前固定返回空字符串

业务状态说明

业务状态码	业务状态码解释	备注
100	成功	HTTP 200
501	参数错误	HTTP 400
502	请求频率受限	HTTP 429
503	订单到期	HTTP 403
504	凭据缺失、无效、无商品权限或鉴权服务不可用	HTTP 401
505	调用额度不足	HTTP 403
901	数据服务暂时不可用	HTTP 503

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功（业务码 100）。

Bodyapplication/json

示例

{
  "DataStatus": {
    "StatusCode": 100,
    "RequestParameter": "type=股票型&symbol=012729",
    "StatusDescription": "请求成功",
    "ResponseDateTime": "2026-07-10 10:52:01.417",
    "DataTotalCount": 1
  },
  "Data": [
    {
      "FundCode": "012729",
      "FundName": "国泰中证动漫游戏ETF联接C",
      "FundType": "指数型-股票",
      "EstimatedValue": 1.2146,
      "EstimatedGrowthRate": 2.9,
      "NetAssetValue": 0,
      "DailyGrowthRate": 0,
      "EstimatedDeviation": 0,
      "NetAssetValueYesterday": 1.1804,
      "SnapshotTime": "2026-07-10 10:51",
      "DataScope": "开放式基金净值估算缓存快照，适用于当前数据源已覆盖的开放式基金。",
      "NoDataReason": ""
    }
  ]
}

🟠400参数错误（业务码 501）。

🟠401凭据缺失、无效、无商品权限或鉴权服务不可用（业务码 504）。

🟠403订单到期（业务码 503）；调用额度不足（业务码 505）。

🟠404资源不存在。请求路径不存在。

🟠405请求方法不允许。当前路径不支持该 HTTP 方法。

🟠415请求内容类型不支持。上传或请求体的内容类型不符合接口要求。

🟠429请求频率受限（业务码 502）。

🔴500服务内部错误。服务端处理异常，请稍后重试。

🔴502上游依赖错误。上游依赖服务不可用或返回异常。

🔴503数据服务暂时不可用（业务码 901）。