接入文件
介面簡介
本介面用於查詢指定基金的歷史規模變化情況。透過傳入基金程式碼,可獲取該基金在不同統計日期的淨資產金額(元)以及較上一統計週期的變化率。資料支援分頁返回,便於開發者整合至金融終端或資料分析系統中。
適用場景
- 投研資料分析:分析基金規模擴張或收縮趨勢,評估資金流向。
- 產品對比展示:在理財平臺展示基金的歷史體量變化,輔助使用者決策。
- 風險監控:監測基金規模異常波動,預警流動性風險。
請求與返回說明
- 請求方式:POST
- 核心引數:
fundCode(必填):基金程式碼,如 "000001"。pageNo(選填):頁碼,預設為 1。pageSize(選填):每頁記錄數,預設 10,最大 50。- 返回結果:
data.list:包含物件陣列,每個物件含assetDate(統計日期)、asset(基金淨資產,單位元)、assetRate(較上期變化率)。code:狀態碼,200 表示成功。taskNo:本次請求的任務編號,用於問題排查。
接入建議
- 快取策略:基金規模資料通常按季度或半年度更新,建議對歷史資料進行本地快取,減少重複請求。
- 異常處理:請校驗返回的
code欄位,非 200 時讀取msg獲取錯誤資訊。 - 資料解讀:
assetRate為百分比數值,正數表示規模增長,負數表示縮減,需結合具體業務邏輯進行格式化展示。
接入示例程式碼
提供 Shell、Python、Go、Java、PHP 等常見接入示例,便於直接接到現有專案裡。
請求示例
{
"fundCode": "基金代码",
"pageNo": "页码,默认1",
"pageSize": "每页记录数,默认10,最大50"
}響應示例
{
"code": 200,
"msg": "成功",
"taskNo": "492823910191448773171202",
"data": {
"list": [
{
"assetDate": "2024-06-30",
"assetRate": 95.9969,
"asset": 5920507.22
}
]
}
}請求欄位
以下欄位根據示例 JSON 自動提取,僅作接入參考。
| 欄位路徑 | 型別 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.fundCode | object | {...} |
| properties.fundCode.type | string | string |
| properties.fundCode.description | string | 基金代码 |
| properties.pageNo | object | {...} |
| properties.pageNo.type | string | string |
響應欄位
以下欄位根據示例 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 | {...} |