接入文档
接口简介
本接口用于查询指定基金代码的历史净值数据。开发者可通过传入基金代码及时间周期参数,获取对应时间段内的单位净值、累计净值、净值日期及日涨幅等关键金融指标,适用于金融数据分析与展示场景。
适用场景
- 金融APP开发:在移动端展示基金产品的历史走势与详细净值记录。
- 投研数据分析:构建量化分析模型,需要批量获取基金历史表现数据。
- 财富管理门户:为高净值客户提供透明的基金业绩回溯与对比功能。
- 自动化报表生成:定期抓取特定基金的阶段性净值变化,生成投资周报或月报。
请求与返回说明
请求方式:POST 核心参数:
fundCode(必填):基金代码,字符串类型。period(选填):查询周期,取值1-8分别代表近1个月、3个月、6个月、1年、3年、5年、今年以来及成立以来。
返回结果: 成功响应包含 data.list 数组,每项包含:
date:净值日期netValue:单位净值totalValue:累计净值dayOfGrowth:日涨幅fundCode:基金代码
接入建议
- 参数校验:请确保传入的
fundCode格式正确,避免因代码错误导致查询失败。 - 周期选择:根据业务需求合理选择
period参数,避免频繁请求全量历史数据以优化性能。 - 数据缓存:鉴于基金净值更新频率通常为交易日每日一次,建议在本地实施适当的数据缓存策略,减少重复API调用。
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
请求示例
{
"fundCode": "基金代码",
"period": "取值说明:取值1:近一个月;取值2:近3个月;取值3:近6个月;取值4:近一年;取值5:近三年;取值6:近五年;取值7:今年以来;取值8:成立以来\t"
}响应示例
{
"code": 200,
"msg": "成功",
"taskNo": "914968093149234333232591",
"data": {
"list": [
{
"date": "2024-06-30",
"totalValue": 0.8379,
"fundCode": "018124",
"netValue": 0.8379,
"dayOfGrowth": -0.01
}
]
}
}请求字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.fundCode | object | {...} |
| properties.fundCode.type | string | string |
| properties.fundCode.description | string | 基金代码 |
| properties.period | object | {...} |
| properties.period.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 | {...} |