接入文档
接口简介
本接口用于获取当前市场新发行基金的列表数据。支持通过销售状态(可售/不可售)进行筛选,并提供分页功能。返回数据包含基金代码、名称、类型、基金经理、认购起止日期、起购金额及费率等核心字段,帮助开发者快速集成基金首发资讯。
适用场景
- 金融资讯平台:展示最新发行的基金产品,丰富内容库。
- 理财APP:为用户提供新基认购提醒和对比功能。
- 投顾系统:分析新发基金的市场分布与类型趋势。
请求与返回说明
- 请求方式:POST
- 关键参数:
saleStatus:销售状态,true为可售,false为不可售。pageNo:页码,默认1。pageSize:每页记录数,默认10,最大50。- 返回结果:
data.data:基金对象数组,包含fundCode(基金代码)、fundName(基金名称)、beginDate(认购开始日)、endDate(认购结束日)、fundManagerName(基金经理)等。data.count:总记录数,用于前端分页计算。
接入建议
- 分页处理:建议根据
data.count和pageSize实现前端分页加载,避免一次性请求过多数据。 - 缓存策略:新发基金数据更新频率相对较低,建议对列表数据进行短期缓存(如1-4小时),以减少API调用次数。
- 状态过滤:若仅展示可购买产品,请将
saleStatus设置为true,提升用户转化率。
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
请求示例
{
"saleStatus": "销售状态,true为可售,false为不可售",
"pageNo": "页码,默认1",
"pageSize": "每页记录数,默认10,最大50"
}响应示例
{
"code": 200,
"msg": "成功",
"taskNo": "492823910191448773171202",
"data": {
"data": [
{
"fundType": "混合型-偏股",
"beginDate": "2024-07-08",
"fundCode": "021370",
"endDate": "2024-08-02",
"fundOriginalFee": "",
"minPurchase": "10",
"fundDiscountFee": "0.00%",
"saleStatus": true,
"fundManagerName": "孙蒙",
"fundName": "华夏智胜优选混合发起式C"
}
],
"limit": "20",
"count": 144,
"page": "1"
}
}请求字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.saleStatus | object | {...} |
| properties.saleStatus.type | string | string |
| properties.saleStatus.description | string | 销售状态,true为可售,false为不可售 |
| properties.pageNo | object | {...} |
| properties.pageNo.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 | {...} |