POSTfund-rate
基金费率数据
基金费率数据
接入文档
接口简介
本接口提供基于基金代码（fundCode）的精细化费率数据查询服务。返回内容涵盖基金的申购费率（purchaeRate）、赎回费率（redeemRate）、认购费率（subscribeRate）的分档明细，以及基金管理费、托管费、销售服务费等固定费率指标。同时提供买入/卖出确认日、定投状态、最低申购/赎回金额等交易规则数据，帮助开发者构建透明的基金交易展示层。
适用场景
- 金融理财APP：在基金详情页展示精确的交易成本，包括不同持有期限的赎回费率和不同金额的申购优惠。
- 投顾分析系统：计算基金持仓的综合费率成本，辅助用户进行长期收益预估。
- 基金对比工具：横向比较不同基金的管理费、托管费及交易门槛，提供决策支持。
- 自动化交易系统：校验交易指令是否符合最小申购金额、单日限额及封闭期限制。
请求与返回说明
- 请求方式：POST
- 核心参数：
fundCode（字符串，必填），即标准的6位基金代码。 - 返回数据：
data.purchaeRate/data.redeemRate：JSON字符串格式，包含金额区间或持有时间对应的具体费率值。data.trusteeRate/data.serviceRate：分别为年化的基金管理费和托管费。data.minPurchase/data.minRedeem：最低申购和赎回额度。data.purchaeComfirmDay/data.redeemComfirmDay：交易确认所需工作日天数。data.regularStatus：标识该基金是否开启定投功能（1为开启，0为关闭）。
接入建议
- 数据解析：费率相关字段（如
purchaeRate）通常以 JSON 字符串形式返回，前端或后端需进行二次解析才能渲染阶梯费率表。 - 缓存策略：基金费率调整频率较低，建议对查询结果进行适当缓存（如24小时），以减少API调用次数并提升响应速度。
- 异常处理：需处理基金代码不存在或已清盘的情况，检查返回码
code是否为200，并关注msg提示信息。 - 合规展示：展示费率时请保留原始数据的精度，并注明“费率仅供参考，以基金公司最新公告为准”，避免合规风险。
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例，便于直接接到现有项目里。
请求示例
{
"fundCode": "基金代码"
}响应示例
{
"code": 200,
"msg": "成功",
"taskNo": "492823910191448773171202",
"data": {
"saleRate": "0.00",
"regularStatus": 1,
"redeemRate": "[{\"money\":\"\",\"time\":\"持有期限 < 7天\",\"source\":\"\",\"rate\":\"1.50%\"},{\"money\":\"\",\"time\":\"7天 ≤ 持有期限 < 30天\",\"source\":\"\",\"rate\":\"0.75%\"},{\"money\":\"\",\"time\":\"30天 ≤ 持有期限 < 180天\",\"source\":\"\",\"rate\":\"0.50%\"},{\"money\":\"\",\"time\":\"持有期限 ≥ 180天\",\"source\":\"\",\"rate\":\"0.00%\"}]",
"maxDayPurchae": "100000000000",
"purchaeRate": "[{\"money\":\"购买金额 < 50万\",\"time\":\"\",\"source\":\"1.50%\",\"rate\":\"0.15%\"},{\"money\":\"50万 ≤ 购买金额 < 100万\",\"time\":\"\",\"source\":\"1.20%\",\"rate\":\"0.12%\"},{\"money\":\"100万 ≤ 购买金额 < 500万\",\"time\":\"\",\"source\":\"0.60%\",\"rate\":\"0.06%\"},{\"money\":\"购买金额 ≥ 500万\",\"time\":\"\",\"source\":\"1000元\\/笔\",\"rate\":\"1000元\\/笔\"}]",
"appendPurchae": "10",
"redeemComfirmDay": "1",
"purchaeComfirmDay": "1",
"minRegular": "10",
"firstPurchae": "10",
"subscribeRate": "[{\"money\":\"购买金额 < 50万\",\"time\":\"\",\"source\":\"1.20%\",\"rate\":\"0.12%\"},{\"money\":\"50万 ≤ 购买金额 < 100万\",\"time\":\"\",\"source\":\"0.80%\",\"rate\":\"0.08%\"},{\"money\":\"100万 ≤ 购买金额 < 500万\",\"time\":\"\",\"source\":\"0.40%\",\"rate\":\"0.04%\"},{\"money\":\"购买金额 ≥ 500万\",\"time\":\"\",\"source\":\"1000元\\/笔\",\"rate\":\"1000元\\/笔\"}]",
"minPurchase": "10",
"serviceRate": "0.20",
"openDate": "--~--",
"minRedeem": "",
"trusteeRate": "1.20",
"closedPeriod": ""
}
}请求字段
以下字段根据示例 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 | {...} |
