场内基金历史净值

指定日期区间的场内基金日净值。

接口标识：fundopenetfhistory

请求方法：GET

接口路径：/fund/open/etfhistory

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

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

API 功能

按一个场内基金代码查询指定开始日期和结束日期内的日度净值记录。

每条记录包含单位净值、累计净值和日增长率，可用于绘制日度净值曲线。

同时返回对应净值日的申购状态和赎回状态，便于识别暂停申购或赎回情况。

startDate 和 endDate 均使用 yyyyMMdd 格式，并按自然日期进行严格校验。

开始日期可以等于结束日期，但不能晚于结束日期；本接口不限制为交易日。

每次只接受一个 6 位场内基金代码，不支持逗号分隔的批量代码。

无匹配记录时 Data 为空且 DataTotalCount 为 0，不应将其解释为接口结构变化。

本接口返回日度净值，不提供分钟价格与成交量；分钟行情请使用场内基金分时接口。

请求参数

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

symbol（string，必填，默认：511010）：必填。单个 6 位场内基金代码，保留前导零；不支持市场前缀或多个代码

startDate（string，必填，默认：20260701）：必填。查询开始日期，严格使用 yyyyMMdd 格式，例如 20260701

endDate（string，必填，默认：20260710）：必填。查询结束日期，严格使用 yyyyMMdd 格式；可以与 startDate 相同，但不得早于 startDate

返回参数

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.NAVDate（string，必返）：当前净值记录日期，格式为 yyyyMMdd

Data.NAV（number，必返）：对应 NAVDate 的单位净值，不等同于场内成交价格

Data.CumulativeNetworth（number，必返）：对应 NAVDate 的累计净值，包含历史分红等累计影响

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

Data.SubscriptionStatus（string，必返）：对应 NAVDate 的基金申购状态，例如开放申购或暂停申购

Data.RedemptionStatus（string，必返）：对应 NAVDate 的基金赎回状态，例如开放赎回或暂停赎回

响应约定

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",
        "NAVDate": "string",
        "NAV": 0,
        "CumulativeNetworth": 0,
        "DailyGrowthRate": 0,
        "SubscriptionStatus": "string",
        "RedemptionStatus": "string"
    }
}

🟠400

🟠401

🟠403

🟠404

🟠405

🟠415

🟠429

🔴500

🔴502

场内基金历史净值

场内基金历史净值#

API 功能#

请求参数#

返回参数#

响应约定#

请求参数

请求示例代码

返回响应

场内基金历史净值

API 功能

请求参数

返回参数

响应约定