基金走勢數據

介面簡介

本介面提供基於基金程式碼的金融資料查詢服務。輸入基金程式碼後，返回該基金的型別（如混合、股票、債券等）、不同時間維度（近一週、一月、一季、半年、一年）的漲跌幅資料，以及包含具體日期和淨值的基金歷史走勢列表。資料適用於需要展示基金業績表現的應用場景。

適用場景

• 金融資訊APP：在基金詳情頁展示近期業績表現和歷史淨值曲線。
• 投顧分析工具：快速對比不同基金在特定週期內的收益率變化。
• 個人記賬/理財軟體：幫助使用者追蹤持有基金的階段性盈虧情況。
• 資料視覺化大屏：作為後端資料來源，渲染基金長期走勢圖表。

請求與返回說明

• 請求方式：POST
• 核心引數：fundCode（字串，必填），即目標基金的唯一程式碼。
• 返回資料：
• fundType：基金分類標識（BLEND混合型, STOCK股票型, INDEX指數型, BOND債券型, CURRENCY貨幣型）。
• lastWeek/lastMonth/lastQuarter/lastHalfYear/lastYear：各週期漲跌幅數值（注意：返回值為小數形式，展示時需乘以100%轉換為百分比）。
• fundAndIndexYieldVoPair：包含基金名稱及fundTrends陣列，陣列內物件包含reportDate（時間戳）和value（單位淨值），用於繪製走勢圖。

接入建議

1. 數值處理：介面返回的漲跌幅為小數格式（如-0.3620），前端展示時請務必轉換為百分比格式（-36.20%）。
2. 時間戳轉換：reportDate和serverTime均為毫秒級時間戳，解析時需轉換為標準日期格式。
3. 快取策略：基金淨值通常按交易日更新，非交易時段資料不變，建議對相同fundCode的請求設定適當的快取時間（如24小時），以減少API呼叫成本並提升響應速度。
4. 異常處理：請檢查返回的code欄位，200表示成功，其他狀態碼需結合msg欄位進行錯誤提示。