开放式基金盘中净值估算

盘中估算净值、涨跌率与估算偏差。

接口标识：fundvalueestimation

请求方法：GET

接口路径：/fund/fund-value-estimation

官网文档：https://www.gugudata.com/api/details/fundvalueestimation

OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

API 功能

返回盘中估算净值和估算涨跌率，用于交易时段内观察开放式基金参考走势。

同时返回最近公布的官方单位净值、官方日增长率和前一净值日单位净值。

EstimatedDeviation 表示估算值与最近官方净值之间的偏差，便于比较估算结果。

symbol 可传一个代码，也可使用英文逗号分隔最多 50 个 6 位基金代码。

传入 symbol 时优先按基金代码筛选；未传 symbol 时可使用 type 按基金类型筛选。

type 和 symbol 均可省略，type 空值会按“全部”处理并返回当前可用结果。

非交易时段、基金未被覆盖或数据尚未更新时，可能返回空列表及明确状态说明。

估算结果仅供盘中参考，不等同于基金公司最终公布净值，也不代表可成交价格。

请求参数

appkey（string，必填，默认：YOUR_APPKEY）：必填。接口调用凭证，请在咕咕数据控制台获取；用于身份鉴权和套餐额度校验，不要在公开页面或客户端日志中暴露

type（string，可选，默认：全部）：可选。基金类型筛选值，默认“全部”；空字符串同样按“全部”处理。传入 symbol 后优先按基金代码筛选

symbol（string，可选，默认：空）：可选。传单个 6 位开放式基金代码，或使用英文逗号分隔多个代码，最多 50 个；代码会去重并保留前导零

返回参数

DataStatus.RequestParameter（string，必返）：服务端识别并记录的本次业务查询参数摘要，不包含 APPKEY 等鉴权信息

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，必返）：当前快照对应的盘中估算净值，通常保留至 4 位小数

Data.EstimatedGrowthRate（number，必返）：盘中估算净值相对上一净值日的估算涨跌率，单位为百分比

Data.NetAssetValue（number，必返）：基金公司最近一次公布的官方单位净值，用作估算结果对照

Data.DailyGrowthRate（number，必返）：最近官方单位净值对应的日增长率，单位为百分比

Data.EstimatedDeviation（number，必返）：盘中估算净值与最近官方单位净值之间的数据源偏差值

Data.NetAssetValueYesterday（number，必返）：前一个已公布净值日的官方单位净值

Data.SnapshotTime（string，必返）：当前估算记录的更新时间，通常格式为 yyyy-MM-dd HH:mm；数据源未提供时可能为空

Data.DataScope（string，必返）：当前估算结果适用的基金覆盖范围说明

Data.NoDataReason（string，必返）：有估算数据时通常为空；无匹配结果时具体原因通过 DataStatus.StatusDescription 返回

响应约定

HTTP 200 表示服务已返回结构化响应，业务结果仍应以 DataStatus.StatusCode 为准。

DataStatus.StatusCode=100 表示正常返回；其他值请结合 StatusDescription 处理。

接口标识、URL、HTTP 方法、参数键和响应字段保持兼容；本次仅完善名称和说明。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。

Bodyapplication/json

示例

{
    "DataStatus": {
        "RequestParameter": "string",
        "StatusCode": 0,
        "StatusDescription": "string",
        "ResponseDateTime": "string",
        "DataTotalCount": 0
    },
    "Data": {
        "FundCode": "string",
        "FundName": "string",
        "FundType": "string",
        "EstimatedValue": 0,
        "EstimatedGrowthRate": 0,
        "EstimatedGrowthReferenceValue": 0,
        "NetAssetValue": 0,
        "DailyGrowthRate": 0,
        "EstimatedDeviation": 0,
        "NetAssetValueYesterday": 0,
        "SnapshotTime": "string",
        "IsEstimated": true,
        "EstimateStatus": "string",
        "EstimateMethod": "string",
        "ReferenceNAVDate": "string",
        "EstimateConfidence": 0,
        "HoldingCoverage": 0,
        "ModelVersion": "string",
        "DataScope": "string",
        "NoDataReason": "string"
    }
}

🟠400

🟠401

🟠403

🟠404

🟠405

🟠415

🟠429

🔴500

🔴502

开放式基金盘中净值估算

开放式基金盘中净值估算#

API 功能#

请求参数#

返回参数#

响应约定#

请求参数

请求示例代码

返回响应

开放式基金盘中净值估算

API 功能

请求参数

返回参数

响应约定