內盤期貨合約

介面簡介

本介面提供國內期貨市場（內盤）合約基礎資訊查詢服務。開發者傳入標準的期貨品種程式碼（symbol），即可獲取對應的合約列表，包含合約程式碼及中文全稱（如“上海原油2407”）。資料來源自阿里雲市場上游服務，適用於需要標準化期貨品種標識的業務系統。

適用場景

• 金融終端開發：在交易軟體或行情繫統中展示標準化的合約名稱。
• 資料清洗與對映：將內部系統的簡寫程式碼轉換為通用的中文合約名稱。
• 量化策略回測：構建策略時自動匹配歷史合約的程式碼與名稱對應關係。
• 資訊聚合平臺：確保展示的期貨品種名稱符合國內市場規範。

請求與返回說明

請求方式：POST 請求引數：

• symbol (必填, string)：期貨品種程式碼，需參考官方或上游提供的程式碼表，例如 "SC0"。

返回結果：

• code (number)：狀態碼，200 表示成功。
• msg (string)：狀態描述。
• taskNo (string)：本次請求的唯一追蹤號。
• data.list (array)：合約列表陣列。
• symbol (string)：合約程式碼。
• name (string)：合約中文名稱，包含品種、交易所及到期月份資訊。

接入建議

1. 程式碼規範性：請確保傳入的 symbol 嚴格符合上游定義的格式，大小寫敏感，否則可能導致查詢為空。
2. 快取策略：期貨合約列表變更頻率較低（主要在換月或新合約上市時），建議對返回結果進行本地快取（如 TTL 設定為 24 小時），以減少 API 呼叫次數並提升響應速度。
3. 異常處理：務必檢查返回的 code 欄位，非 200 狀態碼時請根據 msg 提示進行日誌記錄或使用者提示，避免直接解析 data 導致空指標異常。