开放式基金最新净值

单只或全量开放式基金日净值快照。

接口标识：fundopennavrealtime

请求方法：GET

接口路径：/fund/open-nav-realtime

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

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

API 功能

按单个基金代码返回最近一次公布的完整日净值快照，适合基金详情页使用。

同时返回单位净值、累计净值、上一净值日数据、日增长值和日增长率。

包含申购状态、赎回状态和手续费说明，可用于展示基金当前交易可用性。

symbol 留空时返回当前可用的全量开放式基金快照，不提供分页能力。

symbol 仅支持一个标准 6 位基金代码，不接受逗号分隔的批量代码。

与公募基金实时净值接口相比，本接口适合单基金或全量获取，前者支持分页和最多 50 个代码批量查询。

数据日期取基金公司最近一次公布净值的日期，非交易日不一定等于请求当天。

本接口不返回盘中估算值；需要盘中参考时应使用开放式基金净值估算接口。

请求参数

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

symbol（string，可选，默认：017437）：可选。单个 6 位开放式基金代码，保留前导零；不支持市场前缀或多个代码。留空时返回当前可用的全量最新日净值快照

返回参数

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.Symbol（string，必返）：基金的 6 位代码，保留前导零，可用于其他开放式基金接口的 symbol 参数

Data.FundName（string，必返）：基金简称，用于基金详情、列表和搜索结果展示

Data.DateKey（string，必返）：最近一次公布单位净值的日期，格式为 yyyy-MM-dd

Data.UnitNetWorth（number，必返）：基金公司在 DateKey 公布的单位净值，不是盘中估算值

Data.AccumulatedNetWorth（number，必返）：基金公司在 DateKey 公布的累计净值，包含历史分红等累计影响

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

Data.PreviousAccumulatedNetWorth（number，必返）：DateKey 前一个已公布净值日的累计净值

Data.DailyGrowthValue（number，必返）：当前单位净值相对上一净值日的增长值，可为负数或零

Data.DailyGrowthRate（number，必返）：当前单位净值相对上一净值日的增长率，单位为百分比

Data.PurchaseStatus（string，必返）：基金当前申购状态，例如开放申购、暂停申购或限制大额申购

Data.RedemptionStatus（string，必返）：基金当前赎回状态，例如开放赎回或暂停赎回

Data.Fee（string，必返）：数据源公布的申购手续费或费率说明，可能包含百分号或文字说明

响应约定

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

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

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

返回响应

🟢200成功

application/json

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

Bodyapplication/json

示例

{
    "DataStatus": {
        "RequestParameter": "string",
        "StatusCode": 0,
        "StatusDescription": "string",
        "ResponseDateTime": "string",
        "DataTotalCount": 0
    },
    "Data": {
        "Symbol": "string",
        "FundName": "string",
        "DateKey": "string",
        "UnitNetWorth": 0,
        "AccumulatedNetWorth": 0,
        "PreviousUnitNetWorth": 0,
        "PreviousAccumulatedNetWorth": 0,
        "DailyGrowthValue": 0,
        "DailyGrowthRate": 0,
        "PurchaseStatus": "string",
        "RedemptionStatus": "string",
        "Fee": "string"
    }
}

🟠400

🟠401

🟠403

🟠404

🟠405

🟠415

🟠429

🔴500

🔴502

开放式基金最新净值

开放式基金最新净值#

API 功能#

请求参数#

返回参数#

响应约定#

请求参数

请求示例代码

返回响应

开放式基金最新净值

API 功能

请求参数

返回参数

响应约定