接入文档
接口简介
本接口提供公募基金历史分红及送配信息查询服务。开发者只需传入标准基金代码,即可获取该基金过往的分红日期、分红类型(如现金分红或红利再投资)以及具体的分红送配比例数据。
适用场景
- 金融资讯应用:在基金详情页展示历史分红记录,辅助用户评估基金收益稳定性。
- 量化分析系统:批量获取分红数据,用于构建因子模型或回测策略。
- 个人记账工具:自动同步持仓基金的分红到账信息,完善资产报表。
请求与返回说明
- 请求方式:POST
- 核心参数:
fundCode(字符串,必填),即6位基金代码。 - 返回结构:
code:状态码,200表示成功。data.list:数组对象,包含具体分红记录。date:分红权益登记日或发放日。type:分红类型,例如“分红”。rate:分红送配比例数值。fundCode:对应的基金代码。
接入建议
- 缓存策略:基金分红数据属于低频变更的历史数据,建议对查询结果进行本地缓存(如24小时),以减少API调用次数并提升响应速度。
- 异常处理:请校验返回的
code字段,若基金代码不存在或无分红记录,接口可能返回空列表或特定错误码,需做好前端容错展示。 - 数据解读:
rate字段的具体含义(如每10份分红金额)需结合业务场景确认,建议在UI上增加单位说明以提升用户体验。
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
请求示例
{
"fundCode": "基金代码"
}响应示例
{
"code": 200,
"msg": "成功",
"taskNo": "492823910191448773171202",
"data": {
"list": [
{
"date": "2016-06-27",
"fundCode": "000263",
"rate": 0.2772,
"type": "分红"
}
]
}
}请求字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.fundCode | object | {...} |
| properties.fundCode.type | string | string |
| properties.fundCode.description | string | 基金代码 |
| required | array | "fundCode" |
| required[] | string | fundCode |
响应字段
以下字段根据示例 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 | {...} |