接入文件
介面簡介
本介面提供基於基金程式碼的基金經理核心資料查詢服務。呼叫方可獲取指定基金對應的經理上任日期(gmtCreate)以及任職期間的累計漲跌幅(gmtGrowth),幫助快速評估基金經理的歷史管理表現。
適用場景
- 金融終端展示:在基金詳情頁補充經理任期內的業績波動資料。
- 投研資料分析:批次拉取多隻基金的經理任職時長與收益表現,進行橫向對比。
- 智慧投顧系統:作為因子之一,輔助判斷基金管理的穩定性與歷史回報能力。
請求與返回說明
- 請求方式:POST
- 核心引數:
fundCode(字串,必填),即標準的6位基金程式碼。 - 返回結果:JSON陣列,包含以下關鍵欄位:
fundName:基金全稱gmtCreate:經理上任日期(格式:YYYY-MM-DD)gmtGrowth:任職期間漲跌率數值(注意:前端展示時需自行新增百分號%)fundCode:回傳的基金程式碼
接入建議
- 資料精度處理:返回的
gmtGrowth為浮點數,建議在前端或業務層保留兩位小數並格式化顯示。 - 異常處理:若傳入無效基金程式碼,請檢查返回狀態碼並做友好提示,避免直接暴露原始錯誤資訊。
- 快取策略:基金經理變更頻率較低,建議對查詢結果進行適當快取(如24小時),以減少API呼叫次數並提升響應速度。
接入示例程式碼
提供 Shell、Python、Go、Java、PHP 等常見接入示例,便於直接接到現有專案裡。
請求示例
{
"fundCode": "基金代码"
}響應示例
[
{
"fundCode": "004936",
"gmtGrowth": -39.8128,
"fundName": "中航混改精选混合A",
"gmtCreate": "2023-03-30"
}
]請求欄位
以下欄位根據示例 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 | array |
| items | object | {...} |
| items.type | string | object |
| items.properties | object | {...} |
| example | array | {"fundCode":"004936","gmtGrowth":-39.8128,"fundName":"中航混改精选混合A","gmtCreate":"2023-03-30"} |
| example[] | object | {...} |
| example[].fundCode | string | 004936 |