公募基金实时净值

最新开放式基金日净值与申赎状态。

接口标识：fundopenrealtime

请求方法：GET

接口路径：/fund/open/realtime

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

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

API 功能

返回基金公司最近一次公布的单位净值和累计净值，适合展示每日净值快照。

同时返回上一净值日数据、日增长值和日增长率，便于比较前后两个净值日。

包含申购状态、赎回状态和手续费说明，可用于基金详情页和产品筛选。

不传 symbol 时使用 pageIndex 和 pageSize 分页，DataTotalCount 表示全部基金数量。

传入 symbol 时按代码筛选，可使用英文逗号一次查询最多 50 个基金代码。

批量代码会去除首尾空格和重复项，返回结果仍使用标准 6 位基金代码。

数据日期以基金公司最新公布结果为准，非交易日或未更新时不一定等于当天。

本接口不是盘中估值或场内成交行情，盘中参考应使用净值估算或分时行情接口。

请求参数

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

symbol（string，可选，默认：空）：可选。传单个 6 位基金代码，或使用英文逗号分隔多个代码，最多 50 个；代码保留前导零。传入后按代码筛选，pageIndex 和 pageSize 不影响结果，但显式传入时仍须满足合法范围

pageIndex（integer，可选，默认：1）：分页页码，从 1 开始；仅在 symbol 为空时影响结果。即使传入 symbol，显式提供的 pageIndex 也必须大于或等于 1

pageSize（integer，可选，默认：10）：每页返回条数，当前取值范围为 1~50；仅在 symbol 为空时影响结果。即使传入 symbol，显式提供的 pageSize 也必须在合法范围内

返回参数

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 位代码，保留前导零，可直接用于其他基金接口的 symbol 参数

Data.FundABBR（string，必返）：基金简称，用于列表、搜索结果和净值卡片展示

Data.UnitNetworth（number，必返）：基金公司最近一次公布的单位净值，不是盘中估算值或场内成交价

Data.CumulativeNetworth（number，必返）：基金公司最近一次公布的累计净值，包含历史分红等累计影响

Data.PreDayUnitNetworth（number，必返）：前一个已公布净值日的单位净值，用于计算本期净值变化

Data.PreDayCumulativeNetworth（number，必返）：前一个已公布净值日的累计净值，用于比较累计净值变化

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

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

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

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

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

响应约定

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",
        "FundABBR": "string",
        "UnitNetworth": 0,
        "CumulativeNetworth": 0,
        "PreDayUnitNetworth": 0,
        "PreDayCumulativeNetworth": 0,
        "DailyGrowth": 0,
        "DailyGrowthRate": 0,
        "SubscriptionStatus": "string",
        "RedemptionStatus": "string",
        "ServiceCharge": "string"
    }
}

🟠400

🟠401

🟠403

🟠404

🟠405

🟠415

🟠429

🔴500

🔴502

公募基金实时净值

公募基金实时净值#

API 功能#

请求参数#

返回参数#

响应约定#

请求参数

请求示例代码

返回响应

公募基金实时净值

API 功能

请求参数

返回参数

响应约定