接入文件
介面簡介
本介面提供公募基金歷史分紅及送配資訊查詢服務。開發者只需傳入標準基金程式碼,即可獲取該基金過往的分紅日期、分紅型別(如現金分紅或紅利再投資)以及具體的分紅送配比例資料。
適用場景
- 金融資訊應用:在基金詳情頁展示歷史分紅記錄,輔助使用者評估基金收益穩定性。
- 量化分析系統:批次獲取分紅資料,用於構建因子模型或回測策略。
- 個人記賬工具:自動同步持倉基金的分紅到賬資訊,完善資產報表。
請求與返回說明
- 請求方式:POST
- 核心引數:
fundCode(字串,必填),即6位基金程式碼。 - 返回結構:
code:狀態碼,200表示成功。data.list:陣列物件,包含具體分紅記錄。date:分紅權益登記日或發放日。type:分紅型別,例如“分紅”。rate:分紅送配比例數值。fundCode:對應的基金程式碼。
接入建議
- 快取策略:基金分紅資料屬於低頻變更的歷史資料,建議對查詢結果進行本地快取(如24小時),以減少API呼叫次數並提升響應速度。
- 異常處理:請校驗返回的
code欄位,若基金程式碼不存在或無分紅記錄,介面可能返回空列表或特定錯誤碼,需做好前端容錯展示。 - 資料解讀:
rate欄位的具體含義(如每10份分紅金額)需結合業務場景確認,建議在UI上增加單位說明以提升使用者體驗。
接入示例程式碼
提供 Shell、Python、Go、Java、PHP 等常見接入示例,便於直接接到現有專案裡。
請求示例
{
"fundCode": "基金代码"
}響應示例
{
"code": 200,
"msg": "成功",
"taskNo": "492823910191448773171202",
"data": {
"list": [
{
"date": "2016-06-27",
"fundCode": "000263",
"rate": 0.2772,
"type": "分红"
}
]
}
}請求欄位
以下欄位根據示例 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 | {...} |