| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| appkey | string | 否 | 无 | 必填。接口调用凭证,请在咕咕数据控制台获取;用于身份鉴权和套餐额度校验,不要在公开页面或客户端日志中暴露 AppKey 整体必填;在本操作已声明支持的鉴权位置任选一个提供,本位置无需重复填写。多处填写时须一致。 |
| symbol | string | 否 | 无,留空分页查询当前完整基金集合 | 可选。传单个 6 位基金代码,或使用英文逗号分隔多个代码,最多 50 个;代码保留前导零。传入后按代码筛选,pageIndex 和 pageSize 不影响结果,但显式传入时仍须满足合法范围 |
| pageIndex | integer | 否 | 1 | 分页页码,从 1 开始;仅在 symbol 为空时影响结果。即使传入 symbol,显式提供的 pageIndex 也必须大于或等于 1 |
| pageSize | integer | 否 | 10 | 每页返回条数,当前取值范围为 1~50;仅在 symbol 为空时影响结果。即使传入 symbol,显式提供的 pageSize 也必须在合法范围内 |
| 字段 | 类型 | 说明 |
|---|---|---|
| DataStatus.RequestParameter | string | 真实可读的业务参数,不包含凭据。 |
| DataStatus.StatusCode | integer | 成功 100;参数和依赖错误按下列错误说明判断。 |
| DataStatus.StatusDescription | string | 业务状态说明。 |
| DataStatus.ResponseDateTime | string | 接口响应时间。 |
| DataStatus.DataTotalCount | integer | 筛选条件下可用基金总数;未传代码时为当前完整基金集合总数,不是当前页条数。 |
| Data | array | 基金净值结果列表,保持筛选和来源顺序。 |
| Data[].FundCode | string | 基金的 6 位代码,保留前导零,可直接用于其他基金接口的 symbol 参数 |
| Data[].FundABBR | string | 基金简称,用于列表、搜索结果和净值卡片展示 |
| Data[].UnitNetworth | number | 基金公司最近一次公布的单位净值,不是盘中估算值或场内成交价 |
| Data[].CumulativeNetworth | number | 基金公司最近一次公布的累计净值,包含历史分红等累计影响 |
| Data[].PreDayUnitNetworth | number | 前一个已公布净值日的单位净值,用于计算本期净值变化 |
| Data[].PreDayCumulativeNetworth | number | 前一个已公布净值日的累计净值,用于比较累计净值变化 |
| Data[].DailyGrowth | number | 最新单位净值相对上一净值日的增长值,可为负数或零 |
| Data[].DailyGrowthRate | number | 最新单位净值相对上一净值日的 增长率,单位为百分比 |
| Data[].SubscriptionStatus | string | 基金当前申购状态,例如开放申购、暂停申购或限制大额申购 |
| Data[].RedemptionStatus | string | 基金当前赎回状态,例如开放赎回或暂停赎回 |
| Data[].ServiceCharge | string | 数据源公布的申购手续费或费率说明,可能包含百分号或文字说明 |
| 业务状态码 | 业务状态码解释 | 备注 |
|---|---|---|
| 100 | 成功 | HTTP 200 |
| 501 | 参数错误 | HTTP 400 |
| 901 | 处理、依赖失败或超时 | HTTP 503 |
| 502 | 请求频率限制 | HTTP 429 |
| 503 | 权益过期 | HTTP 403 |
| 504 | 凭据缺失或无效、无商品权限、鉴权服务不可用;结合状态判断 | HTTP 401/403/503 |
| 505 | 调用额度不足 | HTTP 403 |