开放式基金区间净值

指定区间的净值、收益、排名与基金事件。

接口标识：fundopennavhistory

请求方法：GET

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

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

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

API 功能

每次按一个基金代码、一种指标和明确日期区间查询，便于控制响应体大小。

支持单位净值、累计净值和累计收益率走势，可用于构建指定区间的基金图表。

支持同类排名及排名百分比，用于观察基金在同类产品中的相对位置变化。

支持分红送配和基金拆分记录，用于查询指定区间内的基金权益事件。

beginDate 和 endDate 使用 yyyyMMdd 格式，二者间隔最大为 366 个自然日。

每次只支持一个标准 6 位基金代码，不接受批量代码或市场前缀。

indicator 使用中文指标名称，返回结果中只有该指标对应的业务字段具有实际含义。

需要一次获取完整历史或最多 20 个基金时，应使用公募基金历史数据接口。

请求参数

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

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

indicator（string，必填，默认：单位净值走势）：必填。仅支持：单位净值走势、累计净值走势、累计收益率走势、同类排名走势、同类排名百分比、分红送配详情、拆分详情；必须传完整中文名称

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

endDate（string，必填，默认：20260710）：必填。查询结束日期，严格使用 yyyyMMdd 格式；不得早于 beginDate，二者间隔最大为 366 个自然日

返回参数

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 位代码，保留前导零

Data.DateKey（string，按所选指标返回）：走势和排名记录日期使用 yyyyMMdd；分红或拆分记录使用事件所属年份，具体取决于 indicator

Data.UnitNetWorth（number，按所选指标返回）：对应 DateKey 的单位净值；仅 indicator=单位净值走势时具有实际含义

Data.DailyGrowthRate（number，按所选指标返回）：对应 DateKey 的单位净值日增长率，单位为百分比；仅单位净值走势使用

Data.CumulativeNetWorth（number，按所选指标返回）：对应 DateKey 的累计净值；仅 indicator=累计净值走势时使用

Data.CumulativeYieldRate（number，按所选指标返回）：对应 DateKey 的累计收益率，单位为百分比；仅累计收益率走势使用

Data.SameTypeRanking（string，按所选指标返回）：同类排名走势时表示排名名次；同类排名百分比时表示排名百分位

Data.TotalRanking（string，按所选指标返回）：当前日期参与同类排名的基金总数；仅同类排名走势使用

Data.EquityRegistrationDate（string，按所选指标返回）：本次基金分红的权益登记日期；仅分红送配详情使用

Data.ExDividendDate（string，按所选指标返回）：本次基金分红的除息日期；仅分红送配详情使用

Data.DividendPerShare（string，按所选指标返回）：本次分红每份基金份额对应的金额说明；仅分红送配详情使用

Data.DividendPaymentDate（string，按所选指标返回）：本次基金分红的实际发放日期；仅分红送配详情使用

Data.SplitConversionDate（string，按所选指标返回）：基金份额拆分或折算的生效日期；仅拆分详情使用

Data.SplitType（string，按所选指标返回）：基金份额拆分、合并或折算的事件类型；仅拆分详情使用

Data.SplitConversionRatio（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": {
        "Symbol": "string",
        "DateKey": "string",
        "UnitNetWorth": 0,
        "DailyGrowthRate": 0,
        "CumulativeNetWorth": 0,
        "CumulativeYieldRate": 0,
        "SameTypeRanking": "string",
        "TotalRanking": "string",
        "EquityRegistrationDate": "string",
        "ExDividendDate": "string",
        "DividendPerShare": "string",
        "DividendPaymentDate": "string",
        "SplitConversionDate": "string",
        "SplitType": "string",
        "SplitConversionRatio": "string"
    }
}

🟠400

🟠401

🟠403

🟠404

🟠405

🟠415

🟠429

🔴500

🔴502

开放式基金区间净值

开放式基金区间净值#

API 功能#

请求参数#

返回参数#

响应约定#

请求参数

请求示例代码

返回响应

开放式基金区间净值

API 功能

请求参数

返回参数

响应约定