國際貴金屬期貨合約

介面簡介

本介面用於查詢國際貴金屬（如白銀 SI 等）的期貨合約程式碼列表。開發者傳入指定的貴金屬品種標識（symbol），即可獲取該品種下所有可交易的期貨合約程式碼陣列，輔助構建交易標的選擇器或行情訂閱基礎資料。

適用場景

• 金融終端開發：在使用者選擇檢視某類貴金屬行情時，動態載入對應的期貨合約選項。
• 量化交易系統：初始化階段獲取全量合約程式碼，用於後續的歷史資料拉取或實時行情訂閱。
• 投資教育平臺：展示不同月份到期的貴金屬期貨合約結構，幫助使用者理解展期規則。

請求與返回說明

• 請求方式：POST
• 核心引數：symbol（必填），字串型別，代表國際貴金屬品種程式碼（例如 "SI" 代表白銀）。需確保傳入的程式碼符合國際通用標準或上游支援的列舉值。
• 返回結果：
• code：狀態碼，200 表示成功。
• data.list：字串陣列，包含該品種下的所有期貨合約程式碼（如 "SI2411", "SI2501" 等，通常由品種程式碼+年月組成）。
• taskNo：本次請求的唯一追蹤 ID，便於問題排查。

接入建議

1. 快取策略：期貨合約列表變更頻率較低（通常在換月或新合約上市時變動），建議對返回結果進行本地快取（如有效期 24 小時），以減少 API 呼叫次數並提升響應速度。
2. 引數校驗：前端應限制 symbol 的輸入範圍，僅允許傳入已知的貴金屬品種程式碼，避免無效請求。
3. 錯誤處理：請根據 code 和 msg 欄位處理異常情況，特別是當傳入不支援的品種程式碼時，介面可能返回非 200 狀態碼或空列表。