接入文件
介面簡介
本介面提供基於基金程式碼(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 | {...} |