國內貴金屬期貨合約

介面簡介

本介面用於查詢國內交易所上市的貴金屬期貨合約基礎資訊。透過傳入品種標識，返回對應的合約程式碼（symbol）及中文名稱（name），幫助開發者構建標準化的交易標的對映表。

適用場景

• 金融終端開發：自動同步上期所黃金、白銀等主力及非主力合約列表。
• 量化策略系統：動態獲取可交易合約程式碼，避免硬編碼導致的合約過期錯誤。
• 行情資料展示：為使用者提供清晰的合約選擇下拉選單，顯示標準合約名稱。

請求與返回說明

• 請求方式：POST
• 關鍵引數：symbol（必填），指定貴金屬品種型別。
• 返回結構：
• code/msg：介面狀態碼及描述。
• data.list：合約陣列，包含 symbol（如 AU2412）和 name（如 黃金2412）。

接入建議

1. 快取機制：合約列表變更頻率較低（通常在換月期），建議本地快取 24 小時以減少呼叫成本。
2. 異常處理：請校驗返回的 code 是否為 200，並妥善處理空列表情況。
3. 資料對映：利用返回的 symbol 作為唯一鍵，關聯實時行情或歷史資料介面。