外盤期貨報價

介面簡介

本介面提供主流外盤期貨品種的實時報價資料。透過傳入特定的期貨品種程式碼（symbol），即可獲取包括最新價、買賣盤口、成交量、持倉量、漲跌幅等核心行情欄位。資料適用於需要監控國際大宗商品及金融衍生品價格的業務場景。

適用場景

• 金融資訊平臺：展示國際期貨市場的實時動態與行情走勢。
• 量化交易輔助：為策略模型提供基礎的價格與量能資料輸入。
• 企業風險管理：監控原材料（如原油、金屬、農產品）的國際價格波動。
• 個人投資工具：開發看盤軟體或價格預警通知服務。

請求與返回說明

• 請求方式：POST
• 關鍵引數：symbol（必填），即期貨品種程式碼，需參考官方程式碼表傳入有效值。
• 返回結構：
• code/msg：介面狀態碼及描述，200 表示成功。
• data：包含具體行情資料的物件。
• price：實時最新價格。
• bid/ask：買一價與賣一價。
• volume/hold：成交量與持倉量。
• change/changeRate：漲跌額與漲跌率。
• update_time：資料更新時間戳。

接入建議

1. 程式碼對映：請務必維護一份有效的 symbol 程式碼表，避免傳入無效程式碼導致查詢失敗。
2. 頻率控制：實時行情資料更新頻繁，建議根據業務實際需求設定合理的輪詢間隔，避免高頻無效請求。
3. 資料校驗：解析返回資料時，請檢查 code 欄位確保請求成功，並注意處理網路異常或超時情況。
4. 時區注意：update_time 為時間戳格式，前端展示時需轉換為使用者本地時區。