指数基金业绩

指数基金收益、费率与跟踪信息。

接口标识：fundbasicindex

请求方法：GET

接口路径：/fund/basic/index

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

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

API 功能

按指数类别和指数基金类型筛选当前可用的指数基金业绩快照。

返回最新单位净值、净值日期和日增长率，用于查看基金最近表现。

覆盖近 1 周、近 1 月、近 3 月、近 6 月、近 1 年及更长周期收益。

同时提供今年以来和成立以来收益率，便于比较短期与长期业绩。

返回基金费率和最低购买金额，可用于产品列表和购买门槛展示。

返回跟踪标的和跟踪方式，用于区分不同指数及被动、增强跟踪策略。

index 和 indicator 均使用固定中文枚举，参数不在支持范围时返回明确错误。

本接口是最新日度业绩快照，不返回盘中成交价格、成交量或分钟行情。

请求参数

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

index（string，必填，默认：沪深指数）：必填。指数类别，仅支持：全部、沪深指数、行业主题、大盘指数、中盘指数、小盘指数、股票指数、债券指数；必须传完整中文名称

indicator（string，必填，默认：被动指数型）：必填。指数基金类型，仅支持：全部、被动指数型、增强指数型；必须传完整中文名称

返回参数

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.FundName（string，必返）：指数基金名称，用于识别基金份额和跟踪产品

Data.NetAssetValue（number，必返）：基金公司最近一次公布的单位净值

Data.TimeKey（string，必返）：最近单位净值对应的日期，通常格式为 yyyy-MM-dd

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

Data.WeekGrowthRate（number，必返）：截至 TimeKey 的近 1 周收益率，单位为百分比

Data.MonthGrowthRate（number，必返）：截至 TimeKey 的近 1 月收益率，单位为百分比

Data.ThreeMonthGrowthRate（number，必返）：截至 TimeKey 的近 3 月收益率，单位为百分比

Data.SixMonthGrowthRate（number，必返）：截至 TimeKey 的近 6 月收益率，单位为百分比

Data.YearGrowthRate（number，必返）：截至 TimeKey 的近 1 年收益率，单位为百分比

Data.TwoYearGrowthRate（number，必返）：截至 TimeKey 的近 2 年收益率，单位为百分比

Data.ThreeYearGrowthRate（number，必返）：截至 TimeKey 的近 3 年收益率，单位为百分比

Data.ThisYearGrowthRate（number，必返）：从本年度首个净值日至 TimeKey 的收益率，单位为百分比

Data.SinceEstablishmentGrowthRate（number，必返）：从基金成立日至 TimeKey 的累计收益率，单位为百分比

Data.Fee（number，必返）：数据源提供的基金费率数值，具体计费以基金销售规则为准

Data.MinPurchaseAmount（string，必返）：基金最低购买金额说明，可能包含金额单位或文字条件

Data.TrackingTarget（string，必返）：基金主要跟踪的指数或标的名称

Data.TrackingMethod（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",
        "FundName": "string",
        "NetAssetValue": 0,
        "TimeKey": "string",
        "DayGrowthRate": 0,
        "WeekGrowthRate": 0,
        "MonthGrowthRate": 0,
        "ThreeMonthGrowthRate": 0,
        "SixMonthGrowthRate": 0,
        "YearGrowthRate": 0,
        "TwoYearGrowthRate": 0,
        "ThreeYearGrowthRate": 0,
        "ThisYearGrowthRate": 0,
        "SinceEstablishmentGrowthRate": 0,
        "Fee": 0,
        "MinPurchaseAmount": "string",
        "TrackingTarget": "string",
        "TrackingMethod": "string"
    }
}

🟠400

🟠401

🟠403

🟠404

🟠405

🟠415

🟠429

🔴500

🔴502

指数基金业绩

指数基金业绩#

API 功能#

请求参数#

返回参数#

响应约定#

请求参数

请求示例代码

返回响应

指数基金业绩

API 功能

请求参数

返回参数

响应约定