接入文档
接口简介
本接口用于获取当前市场在售的公募基金列表数据。通过 POST 请求,开发者可按页码和每页数量拉取基金基础信息,包括基金代码、名称、单位净值、累计净值、日涨幅以及当前的申购和赎回状态。
适用场景
- 金融资讯应用:展示每日更新的基金行情列表。
- 投顾平台:筛选开放申购且状态正常的基金产品供用户选择。
- 数据分析:构建基金基础数据库,监控市场在售产品规模与状态变化。
请求与返回说明
- 请求方式:POST
- 关键参数:
pageNo:页码,默认为 1。pageSize:每页记录数,默认 10,最大支持 50。- 返回核心字段:
fundCode/fundName:基金唯一标识与名称。netValue/totalValue:单位净值与累计净值。dayOfGrowth:日涨幅百分比。saleStatus/redeemStatus:销售状态(如“开放申购”)与赎回状态(如“开放赎回”)。
接入建议
- 分页策略:建议前端采用懒加载或分页控件,避免一次性请求过多数据影响性能。
- 状态过滤:业务层可根据
saleStatus和redeemStatus字段过滤已暂停申赎的基金,提升用户体验。 - 数据缓存:基金净值通常每日更新一次,建议对非实时性要求极高的场景设置适当的本地缓存,减少 API 调用频次。
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
请求示例
{
"pageNo": "页码,默认1",
"pageSize": "每页记录数,默认10,最大50"
}响应示例
{
"code": 200,
"msg": "成功",
"taskNo": "914968093149234333232591",
"data": {
"list": [
{
"totalValue": 0.4439,
"fundCode": "010989",
"netValue": 0.4439,
"dayOfGrowth": 1.93,
"redeemStatus": "开放赎回",
"saleStatus": "开放申购",
"fundName": "南方中证房地产ETF发起联接E"
}
]
}
}请求字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.pageNo | object | {...} |
| properties.pageNo.type | string | string |
| properties.pageNo.description | string | 页码,默认1 |
| properties.pageSize | object | {...} |
| properties.pageSize.type | string | string |
响应字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.code | object | {...} |
| properties.code.type | string | number |
| properties.code.example | number | 200 |
| properties.code.description | string | 返回码,详见返回码说明 |
| properties.msg | object | {...} |