接入文档
接口简介
本接口提供基于基金代码的基金经理核心数据查询服务。调用方可获取指定基金对应的经理上任日期(gmtCreate)以及任职期间的累计涨跌幅(gmtGrowth),帮助快速评估基金经理的历史管理表现。
适用场景
- 金融终端展示:在基金详情页补充经理任期内的业绩波动数据。
- 投研数据分析:批量拉取多只基金的经理任职时长与收益表现,进行横向对比。
- 智能投顾系统:作为因子之一,辅助判断基金管理的稳定性与历史回报能力。
请求与返回说明
- 请求方式:POST
- 核心参数:
fundCode(字符串,必填),即标准的6位基金代码。 - 返回结果:JSON数组,包含以下关键字段:
fundName:基金全称gmtCreate:经理上任日期(格式:YYYY-MM-DD)gmtGrowth:任职期间涨跌率数值(注意:前端展示时需自行添加百分号%)fundCode:回传的基金代码
接入建议
- 数据精度处理:返回的
gmtGrowth为浮点数,建议在前端或业务层保留两位小数并格式化显示。 - 异常处理:若传入无效基金代码,请检查返回状态码并做友好提示,避免直接暴露原始错误信息。
- 缓存策略:基金经理变更频率较低,建议对查询结果进行适当缓存(如24小时),以减少API调用次数并提升响应速度。
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
请求示例
{
"fundCode": "基金代码"
}响应示例
[
{
"fundCode": "004936",
"gmtGrowth": -39.8128,
"fundName": "中航混改精选混合A",
"gmtCreate": "2023-03-30"
}
]请求字段
以下字段根据示例 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 | array |
| items | object | {...} |
| items.type | string | object |
| items.properties | object | {...} |
| example | array | {"fundCode":"004936","gmtGrowth":-39.8128,"fundName":"中航混改精选混合A","gmtCreate":"2023-03-30"} |
| example[] | object | {...} |
| example[].fundCode | string | 004936 |