| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| appkey | string | 否 | 无 | 必填。接口调用凭证,请在咕咕数据控制台获取;用于身份鉴权和套餐额度校验,不要在公开页面或客户端日志中暴露 |
| type | string | 是 | 无 | 必填。基金大类,仅支持:全部、股票型、混合型、债券型、指数型、QDII、FOF;不在支持范围时返回参数错误 |
| 字段 | 类型 | 说明 |
|---|---|---|
| DataStatus.RequestParameter | string | 本次实际业务请求参数,不包含鉴权凭据;Demo 展示对应样例输入。 |
| 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 | 数据源公布的手续费或费率说明,可能包含百分号或文字 |
| 业务状态码 | 业务状态码解释 | 备注 |
|---|---|---|
| 100 | 正常返回 | |
| 101 | 参数错误 | |
| 102 | 请求频率受限 | 默认按来源 IP 限速,单 IP 最多 5 QPS,可满足常规业务调用。超出限制时接口会返回 429 请求频率受限;已购买接口订单可加购 10 QPS 扩展。 |
| 103 | 账号欠费 | |
| 104 | APPKEY 错误 | 请检查传递的 APPKEY 是否为开发者中心获取到的值 |
| 110 | 依赖失败 | HTTP 200;没有可靠完整结果及有效备用。 |