开放式基金业绩排行

按基金类型查看多周期收益排行。

接口标识：fundopenrankinglist

请求方法：GET

接口路径：/fund/fund-open-ranking-list

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

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

API 功能

按基金大类筛选当前可用的开放式基金最新日度业绩排行快照。

每条记录包含单位净值、累计净值、净值日期和当日净值增长率。

覆盖近 1 周、近 1 月、近 3 月、近 6 月和近 1 年收益率。

同时提供近 2 年、近 3 年、今年以来和成立以来收益率。

type 支持全部、股票型、混合型、债券型、指数型、QDII 和 FOF。

type 不区分 QDII、FOF 的英文字母大小写，其他中文类型应传完整名称。

正式接口返回当前类型的全部可用排行记录，无分页参数。

排行依据为基金净值区间收益，不是盘中估算值或场内成交价格涨跌。

请求参数

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

type（string，必填，默认：指数型）：必填。基金大类，仅支持：全部、股票型、混合型、债券型、指数型、QDII、FOF；不在支持范围时返回参数错误

返回参数

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.DateKey（string，必返）：本条业绩排行快照对应的净值日期，通常格式为 yyyy-MM-dd

Data.UnitNetValue（number，必返）：基金在 DateKey 最近公布的单位净值

Data.AccumulatedNetValue（number，必返）：基金在 DateKey 最近公布的累计净值

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

Data.Week（number，必返）：截至排行快照日的近 1 周收益率，单位为百分比

Data.Month（number，必返）：截至排行快照日的近 1 月收益率，单位为百分比

Data.ThreeMonth（number，必返）：截至排行快照日的近 3 月收益率，单位为百分比

Data.SixMonth（number，必返）：截至排行快照日的近 6 月收益率，单位为百分比

Data.Year（number，必返）：截至排行快照日的近 1 年收益率，单位为百分比

Data.TwoYear（number，必返）：截至排行快照日的近 2 年收益率，单位为百分比

Data.ThreeYear（number，必返）：截至排行快照日的近 3 年收益率，单位为百分比

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

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

Data.Custom（number，必返）：数据源提供的自定义统计区间收益率，单位为百分比

Data.Fee（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",
        "DateKey": "string",
        "UnitNetValue": 0,
        "AccumulatedNetValue": 0,
        "DailyGrowthRate": 0,
        "Week": 0,
        "Month": 0,
        "ThreeMonth": 0,
        "SixMonth": 0,
        "Year": 0,
        "TwoYear": 0,
        "ThreeYear": 0,
        "YearToDate": 0,
        "SinceInception": 0,
        "Custom": 0,
        "Fee": "string"
    }
}

🟠400

🟠401

🟠403

🟠404

🟠405

🟠415

🟠429

🔴500

🔴502

开放式基金业绩排行

开放式基金业绩排行#

API 功能#

请求参数#

返回参数#

响应约定#

请求参数

请求示例代码

返回响应

开放式基金业绩排行

API 功能

请求参数

返回参数

响应约定