接入文件
介面簡介
本介面用於獲取當前市場在售的公募基金列表資料。透過 POST 請求,開發者可按頁碼和每頁數量拉取基金基礎資訊,包括基金程式碼、名稱、單位淨值、累計淨值、日漲幅以及當前的申購和贖回狀態。
適用場景
- 金融資訊應用:展示每日更新的基金行情列表。
- 投顧平臺:篩選開放申購且狀態正常的基金產品供使用者選擇。
- 資料分析:構建基金基礎資料庫,監控市場在售產品規模與狀態變化。
請求與返回說明
- 請求方式:POST
- 關鍵引數:
pageNo:頁碼,預設為 1。pageSize:每頁記錄數,預設 10,最大支援 50。- 返回核心欄位:
fundCode/fundName:基金唯一標識與名稱。netValue/totalValue:單位淨值與累計淨值。dayOfGrowth:日漲幅百分比。saleStatus/redeemStatus:銷售狀態(如“開放申購”)與贖回狀態(如“開放贖回”)。
接入建議
- 分頁策略:建議前端採用懶載入或分頁控制元件,避免一次性請求過多資料影響效能。
- 狀態過濾:業務層可根據
saleStatus和redeemStatus欄位過濾已暫停申贖的基金,提升使用者體驗。 - 資料快取:基金淨值通常每日更新一次,建議對非實時性要求極高的場景設定適當的本地快取,減少 API 呼叫頻次。
接入示例程式碼
提供 Shell、Python、Go、Java、PHP 等常見接入示例,便於直接接到現有專案裡。
請求示例
{
"pageNo": "页码,默认1",
"pageSize": "每页记录数,默认10,最大50"
}響應示例
{
"code": 200,
"msg": "成功",
"taskNo": "914968093149234333232591",
"data": {
"list": [
{
"totalValue": 0.4439,
"fundCode": "010989",
"netValue": 0.4439,
"dayOfGrowth": 1.93,
"redeemStatus": "开放赎回",
"saleStatus": "开放申购",
"fundName": "南方中证房地产ETF发起联接E"
}
]
}
}請求欄位
以下欄位根據示例 JSON 自動提取,僅作接入參考。
| 欄位路徑 | 型別 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.pageNo | object | {...} |
| properties.pageNo.type | string | string |
| properties.pageNo.description | string | 页码,默认1 |
| properties.pageSize | object | {...} |
| properties.pageSize.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 | {...} |