| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| appkey | string | 否 | 无 | 必填。接口调用凭证,请在咕咕数据控制台获取;用于身份鉴权和套餐额度校验,不要在公开页面或客户端日志中暴露 AppKey 整体必填;在本操作已声明支持的鉴权位置任选一个提供,本位置无需重复填写。多处填写时须一致。 |
| type | string | 否 | 无 | 可选。按 FundType 精确筛选,不区分英文字母大小写;留空时不限制基金类型 |
| keyword | string | 否 | 无 | 可选。按基金代码或基金名称进行不区分大小写的模糊筛选 |
| pageIndex | integer | 否 | 1 | 可选。分页页码,从 1 开始;仅传 pageSize 时默认使用第 1 页 |
| pageSize | integer | 否 | 100 | 可选。每页数量,取值范围 1~500;未传 pageIndex 和 pageSize 时返回全部匹配记录 |
| 字段 | 类型 | 说明 |
|---|---|---|
| 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.FundType | string | 基金所属类型,用于区分不同场内基金类别 |
| Data.DateKey | string | 本条业绩排行对应的净值日期,通常格式为 yyyy-MM-dd。 |
| Data.UnitNetValue | number | 基金在 DateKey 最近公布的单位净值 |
| Data.AccumulatedNetValue | number | 基金在 DateKey 最近公布的累计净值 |
| Data.Week | number | 截至 DateKey 的近 1 周收益率,单位为百分比。 |
| Data.Month | number | 截至 DateKey 的近 1 月收益率,单位为百分比。 |
| Data.ThreeMonth | number | 截至 DateKey 的近 3 月收益率,单位为百分比。 |
| Data.SixMonth | number | 截至 DateKey 的近 6 月收益率,单位为百分比。 |
| Data.Year | number | 截至 DateKey 的近 1 年收益率,单位为百分比。 |
| Data.TwoYear | number | 截至 DateKey 的近 2 年收益率,单位为百分比。 |
| Data.ThreeYear | number | 截至 DateKey 的近 3 年收益率,单位为百分比。 |
| Data.YearToDate | number | 从本年度首个净值日至 DateKey 的收益率,单位为百分比。 |
| Data.SinceInception | number | 从基金成立日至 DateKey 的累计收益率,单位为百分比。 |
| Data.EstablishingDate | string | 基金成立日期,通常格式为 yyyy-MM-dd |
| 业务状态码 | 业务状态码解释 | 备注 |
|---|---|---|
| 100 | 正常返回 | 请求成功。 |
| 501 | 参数错误 | 请检查筛选条件、分页范围及是否包含未知或重复参数。 |
| 502 | 请求频率受限 | 请按套餐 QPS 控制请求频率。 |
| 503 | 订单到期 | 请检查接口订单状态。 |
| 504 | APPKEY 错误 | 请检查 APPKEY 及其传递位置。 |
| 505 | 接口额度耗尽 | 请检查剩余调用额度。 |
| 900 | 接口内部错误 | 请稍后重试。 |
| 901 | 数据服务暂不可用 | 请稍后重试;持续失败时请联系技术支持。 |