POSTfund-yield
基金走势数据
基金走势数据
接入文档
接口简介
本接口提供基于基金代码的金融数据查询服务。输入基金代码后,返回该基金的类型(如混合、股票、债券等)、不同时间维度(近一周、一月、一季、半年、一年)的涨跌幅数据,以及包含具体日期和净值的基金历史走势列表。数据适用于需要展示基金业绩表现的应用场景。
适用场景
- 金融资讯APP:在基金详情页展示近期业绩表现和历史净值曲线。
- 投顾分析工具:快速对比不同基金在特定周期内的收益率变化。
- 个人记账/理财软件:帮助用户追踪持有基金的阶段性盈亏情况。
- 数据可视化大屏:作为后端数据源,渲染基金长期走势图表。
请求与返回说明
- 请求方式:POST
- 核心参数:
fundCode(字符串,必填),即目标基金的唯一代码。 - 返回数据:
fundType:基金分类标识(BLEND混合型, STOCK股票型, INDEX指数型, BOND债券型, CURRENCY货币型)。lastWeek/lastMonth/lastQuarter/lastHalfYear/lastYear:各周期涨跌幅数值(注意:返回值为小数形式,展示时需乘以100%转换为百分比)。fundAndIndexYieldVoPair:包含基金名称及fundTrends数组,数组内对象包含reportDate(时间戳)和value(单位净值),用于绘制走势图。
接入建议
- 数值处理:接口返回的涨跌幅为小数格式(如-0.3620),前端展示时请务必转换为百分比格式(-36.20%)。
- 时间戳转换:
reportDate和serverTime均为毫秒级时间戳,解析时需转换为标准日期格式。 - 缓存策略:基金净值通常按交易日更新,非交易时段数据不变,建议对相同
fundCode的请求设置适当的缓存时间(如24小时),以减少API调用成本并提升响应速度。 - 异常处理:请检查返回的
code字段,200表示成功,其他状态码需结合msg字段进行错误提示。
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
请求示例
{
"fundCode": "基金代码"
}响应示例
{
"code": 200,
"msg": "成功",
"taskNo": "200495341220681616635742",
"data": {
"fundType": "BLEND",
"lastYear": "-0.3620",
"lastQuarter": "-0.1032",
"serverTime": 1722409638300,
"lastMonth": "-0.0221",
"lastHalfYear": "-0.1331",
"lastWeek": "-0.0124",
"fundAndIndexYieldVoPair": [
{
"name": "中航混改精选混合型证券投资基金A类",
"trendType": "INDEX_CODE-sz399300",
"fundTrends": [
{
"code": "20171027000230030000000000014020",
"codeType": "PRODUCT_ID",
"reportDate": 1714406400000,
"name": "中航混改精选混合型证券投资基金A类",
"value": "0.810300"
}
]
}
]
}
}请求字段
以下字段根据示例 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 | {...} |