POST已開放fund-rank

基金收益排名

呼叫價格

10 匠幣/次

線上除錯

無需寫程式，瀏覽器中直接發起真實請求

接入文件

介面簡介

本介面提供單隻基金的詳細業績表現資料。透過傳入基金程式碼，返回該基金在不同時間維度（近一週、近一月、近一季、今年以來、近兩年、近三年、近五年）的漲跌幅、同類平均漲跌幅、同類排名以及相對於滬深300指數的超額收益情況。

適用場景

金融資訊應用：在基金詳情頁展示多維度的歷史業績走勢與排名。
投研分析工具：量化分析基金長期穩定性，對比同類平均水平與基準指數。
智慧投顧系統：基於歷史排名和收益率篩選優質基金標的。

請求與返回說明

請求方式：POST
核心引數：fundCode（字串，必填），即需要查詢的基金六位程式碼。
返回資料：
data.lastWeek / lastMonth / lastQuarter 等：對應週期的實際漲跌幅。
data.lastWeekRank / lastMonthRank 等：對應週期在同類基金中的排名。
data.lastWeekAvg / lastMonthAvg 等：對應週期同類基金的平均漲跌幅。
data.lastWeekHS300 等：對應週期相對於滬深300指數的表現。
data.foundDate：基金成立日期。

接入建議

快取策略：基金淨值與排名資料通常每日更新一次，建議對同一基金程式碼的查詢結果進行至少24小時的本地快取，以減少API呼叫成本。
異常處理：請檢查返回的 code 欄位，若為非200狀態碼，需根據 msg 提示進行錯誤處理（如基金程式碼不存在）。
資料展示：前端展示排名時，建議結合 lastWeekCount 等總數量欄位，計算百分比排名（如“前10%”），提升使用者閱讀體驗。

接入示例程式碼

提供 Shell、Python、Go、Java、PHP 等常見接入示例，便於直接接到現有專案裡。

請求示例

{
  "fundCode": "基金代码"
}

響應示例

{
  "code": 200,
  "msg": "成功",
  "taskNo": "492823910191448773171202",
  "data": {
    "twoYear": -38.46,
    "fiveYearCount": 757,
    "allYearHS300": 0,
    "nowYearRank": 2499,
    "lastWeekCount": 4350,
    "lastMonthAvg": -2.15,
    "lastMonth": 2.17,
    "lastQuarterAvg": -6.32,
    "thirdYearAvg": -36.24,
    "lastHalfYearAvg": 7.82,
    "lastHalfYearRank": 4019,
    "nowYearHS300": 0.32,
    "lastYearRank": 3688,
    "twoYearCount": 3133,
    "lastQuarter": -6.31,
    "allYearCount": 0,
    "fiveYearHS300": -10.25,
    "lastWeekAvg": 1.56,
    "lastWeekHS300": 0.7,
    "foundDate": "2017-12-14",
    "lastQuarterHS300": -4.5,
    "lastQuarterRank": 2095,
    "lastWeek": 6.51,
    "lastWeekRank": 34,
    "lastMonthHS300": -0.57,
    "fiveYear": -27.58,
    "lastYearCount": 3822,
    "nowYear": -9.91,
    "twoYearAvg": -27.66,
    "thirdYearCount": 2063,
    "lastMonthRank": 227,
    "thirdYearRank": 1447,
    "nowYearAvg": -7.31,
    "fiveYearAvg": 22.95,
    "allYearAvg": "",
    "twoYearHS300": -17.46,
    "lastHalfYearCount": 4171,
    "allYearRank": 0,
    "lastYearAvg": -17.7,
    "thirdYear": -44.54,
    "fiveYearRank": 737,
    "allYear": -24.08,
    "dataDate": "2024-07-31",
    "thirdYearHS300": -28.46,
    "lastHalfYearHS300": 7.05,
    "lastYearHS300": -14.26,
    "nowYearCount": 4123,
    "twoYearRank": 2547,
    "lastYear": -34.4,
    "lastQuarterCount": 4295,
    "lastHalfYear": -6.16,
    "lastMonthCount": 4357
  }
}

請求欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
type	string	object
properties	object	{...}
properties.fundCode	object	{...}
properties.fundCode.type	string	string
properties.fundCode.description	string	基金代码
required	array	"fundCode"
required[]	string	fundCode

響應欄位