公募基金历史数据

完整历史净值、收益、排名与基金事件。

接口标识：fundopenhistory

请求方法：GET

接口路径：/fund/open/history

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

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

API 功能

一次获取基金可用的完整历史序列，不要求传入开始日期和结束日期。

支持单位净值、累计净值和累计收益率三类历史走势，适合绘制长期净值曲线。

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

支持分红送配和基金拆分记录，可用于还原影响累计净值的历史基金事件。

支持货币基金每万份收益、7 日年化收益率以及申购赎回状态历史。

普通基金最多可批量查询 20 个代码，货币基金历史每次查询一个代码。

type 决定 Data 中实际出现的业务字段，接入时应按所选指标读取对应字段。

需要限制查询日期或控制响应体大小时，建议改用开放式基金区间净值接口。

请求参数

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

symbol（string，必填，默认：007401）：基金代码。普通基金可传单个代码，或使用英文逗号分隔最多 20 个 6 位代码；MONETARY 货币基金模式每次仅支持一个代码

type（string，必填，默认：NAVTREND）：返回指标。NAVTREND 为单位净值走势；ACCUMULATEDNETWORTHTREND 为累计净值走势；ACCUMULATEDRATEOFRETURN 为累计收益率；SIMILARRANKINGS 为同类排名；SIMILARRANKINGSPERCENT 为排名百分比；DIVIDENDDETAILS 为分红；SPLITDETAILS 为拆分；MONETARY 为货币基金收益

返回参数

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.FundShort（string，必返）：当前历史记录所属基金的简称

Data.FundType（string，必返）：基金所属类型；用于批量查询时区分不同基金类别

Data.DateKey（integer，按所选指标返回）：净值、收益、排名或货币基金记录日期，格式为 yyyyMMdd；仅相关 type 返回

Data.NetAssetValue（number，按所选指标返回）：对应 DateKey 的单位净值；仅 NAVTREND 模式返回

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

Data.AccumulatedNetWorth（number，按所选指标返回）：对应 DateKey 的累计净值；仅 ACCUMULATEDNETWORTHTREND 返回

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

Data.SimilarRanking（integer，按所选指标返回）：该基金在同类基金中的近 3 月收益排名；仅 SIMILARRANKINGS 返回

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

Data.SimilarRankingPercent（number，按所选指标返回）：该基金同类近 3 月收益排名所处百分位；仅 SIMILARRANKINGSPERCENT 返回

Data.Year（string，按所选指标返回）：分红或拆分事件所属年份；仅 DIVIDENDDETAILS、SPLITDETAILS 返回

Data.RightsRegistrationDay（string，按所选指标返回）：分红权益登记日期；仅 DIVIDENDDETAILS 返回

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

Data.PerShare（string，按所选指标返回）：本次分红每份基金份额对应的分红金额说明；仅 DIVIDENDDETAILS 返回

Data.ShareDividendDate（string，按所选指标返回）：本次基金分红的实际发放日期；仅 DIVIDENDDETAILS 返回

Data.SplitDate（string，按所选指标返回）：基金份额拆分或折算生效日期；仅 SPLITDETAILS 返回

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

Data.SplitRatio（string，按所选指标返回）：基金份额拆分或折算比例说明；仅 SPLITDETAILS 返回

Data.PerTenThousandIncome（string，按所选指标返回）：货币基金对应日期的每万份收益；仅 MONETARY 返回

Data.SevenDayAnnualizedIncome（number，按所选指标返回）：货币基金对应日期的 7 日年化收益率，单位为百分比；仅 MONETARY 返回

Data.PurchaseStatus（string，按所选指标返回）：货币基金对应日期的申购开放状态；仅 MONETARY 返回

Data.RedemptionStatus（string，按所选指标返回）：货币基金对应日期的赎回开放状态；仅 MONETARY 返回

响应约定

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": {
        "FundCode": "string",
        "FundShort": "string",
        "FundType": "string",
        "DateKey": 0,
        "NetAssetValue": 0,
        "DayGrowthRate": 0,
        "AccumulatedNetWorth": 0,
        "AccumulatedRateofReturn": 0,
        "SimilarRanking": 0,
        "TotalRanking": 0,
        "SimilarRankingPercent": 0,
        "Year": "string",
        "RightsRegistrationDay": "string",
        "ExDividendDate": "string",
        "PerShare": "string",
        "ShareDividendDate": "string",
        "SplitDate": "string",
        "SplitType": "string",
        "SplitRatio": "string",
        "PerTenThousandIncome": "string",
        "SevenDayAnnualizedIncome": 0,
        "PurchaseStatus": "string",
        "RedemptionStatus": "string"
    }
}

🟠400

🟠401

🟠403

🟠404

🟠405

🟠415

🟠429

🔴500

🔴502

公募基金历史数据

公募基金历史数据#

API 功能#

请求参数#

返回参数#

响应约定#

请求参数

请求示例代码

返回响应

公募基金历史数据

API 功能

请求参数

返回参数

响应约定