接入文档
接口简介
本接口用于查询指定基金的历史规模变化情况。通过传入基金代码,可获取该基金在不同统计日期的净资产金额(元)以及较上一统计周期的变化率。数据支持分页返回,便于开发者集成至金融终端或数据分析系统中。
适用场景
- 投研数据分析:分析基金规模扩张或收缩趋势,评估资金流向。
- 产品对比展示:在理财平台展示基金的历史体量变化,辅助用户决策。
- 风险监控:监测基金规模异常波动,预警流动性风险。
请求与返回说明
- 请求方式:POST
- 核心参数:
fundCode(必填):基金代码,如 "000001"。pageNo(选填):页码,默认为 1。pageSize(选填):每页记录数,默认 10,最大 50。- 返回结果:
data.list:包含对象数组,每个对象含assetDate(统计日期)、asset(基金净资产,单位元)、assetRate(较上期变化率)。code:状态码,200 表示成功。taskNo:本次请求的任务编号,用于问题排查。
接入建议
- 缓存策略:基金规模数据通常按季度或半年度更新,建议对历史数据进行本地缓存,减少重复请求。
- 异常处理:请校验返回的
code字段,非 200 时读取msg获取错误信息。 - 数据解读:
assetRate为百分比数值,正数表示规模增长,负数表示缩减,需结合具体业务逻辑进行格式化展示。
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
请求示例
{
"fundCode": "基金代码",
"pageNo": "页码,默认1",
"pageSize": "每页记录数,默认10,最大50"
}响应示例
{
"code": 200,
"msg": "成功",
"taskNo": "492823910191448773171202",
"data": {
"list": [
{
"assetDate": "2024-06-30",
"assetRate": 95.9969,
"asset": 5920507.22
}
]
}
}请求字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.fundCode | object | {...} |
| properties.fundCode.type | string | string |
| properties.fundCode.description | string | 基金代码 |
| 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 | {...} |