期貨合約資訊

POST /v1/quote/future-info

獲取期貨合約的基本資訊（交易所、交易時間、合約規模、價格單位、最小變動等）。

請求參數

參數	類型	位置	必填	說明
code_list	string[]	請求體	是	期貨合約代碼列表，單次最多 400 個；例 ["HK.HSImain", "US.CLmain"]。

請求示例

curl -X POST '$ip/v1/quote/future-info' \
  -H 'Content-Type: application/json' \
  -d '{"code_list": ["HK.HSImain"]}' | jq

響應字段

返回 data.future_info_list[]，每元素一個合約資訊：

字段	類型	說明
code	string	合約代碼，例 HK.HSImain。
name	string	合約名稱，例 HSI Futures (JUN6)。
owner	string	標的代碼或品種代碼（指數期貨為指數代碼，商品期貨為品種名）。
exchange	string	交易所簡稱：HKEX / CME / CBOT / NYMEX / COMEX / CBOE / SGX / OSE。
type	string	合約類型：Equity Index / Single Stock / Metals / Energy / Agricultural / Interest Rates / Cryptocurrency / FX。
size	float	合約規模數值。
size_unit	string	合約規模單位，例 Index Points×HKD、barrels。
price_currency	string	報價貨幣：HKD / USD / CNH / SGD / JPY。
price_unit	string	報價單位，例 Index Point、Quote*1000 USD。
min_change	float	最小變動價位數值。
min_change_unit	string	最小變動價位單位，例 Index Point、USD/barrels。
trade_time	string	交易時段，例 (09:15 - 12:00), (13:00 - 16:30), (17:15 - 03:00)。(T-1) 表示前一交易日。
time_zone	string	交易所時區簡稱：CCT / ET / CT / SGT / JST。
last_trade_time	int	最後交易時間（毫秒時間戳）；主連/連續合約固定為 0。
exchange_format_url	string	交易所合約規則頁 URL。
delivery_type	string	交割方式：UNKNOWN / PHYSICAL / CASH。

限制範圍

• 支持的市場：HK / US / SG / JP（覆蓋 HKEX、CME 集團、SGX、OSE 等主要期貨交易所）。
• 支持的品類：僅期貨合約，包括主連/連續合約（代碼以 main 結尾）和月份合約（帶具體年月）。
• 不支持的輸入（正股 / ETF / 指數 / 期權 / 窩輪等）會被靜默丟棄，調用方應通過返回列表中的 code 字段對照入參判斷哪些 code 未被識別。

錯誤碼

ret_code	error.code	觸發條件	處理建議
0	—	成功（包括所有 code 被靜默丟棄時返回空數組）	檢查 future_info_list 長度，對照 code 字段判斷哪些 code 未被識別
-3	invalid_parameter	code_list 缺失 / 為空 / 超過 400 項	修正入參後重試
其他負數	internal_error	網關或後端內部錯誤	重試；若持續失敗聯繫網關側

響應示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "future_info_list": [
      {
        "code": "HK.HSImain",
        "name": "HSI Futures (JUN6)",
        "owner": "HK.800000",
        "exchange": "HKEX",
        "type": "Equity Index",
        "size": 50,
        "size_unit": "Index Points×HKD",
        "price_currency": "HKD",
        "price_unit": "Index Point",
        "min_change": 1,
        "min_change_unit": "Index Point",
        "trade_time": "(09:15 - 12:00), (13:00 - 16:30), (17:15 - 03:00)",
        "time_zone": "CCT",
        "last_trade_time": 0,
        "exchange_format_url": "https://www.hkex.com.hk/...HSI...",
        "delivery_type": "CASH"
      },
      {
        "code": "US.CLmain",
        "name": "Crude Oil Futures (JUL6)",
        "owner": "Crude Oil",
        "exchange": "NYMEX",
        "type": "Energy",
        "size": 1000,
        "size_unit": "barrels",
        "price_currency": "USD",
        "price_unit": "Quote*1000 USD",
        "min_change": 0.01,
        "min_change_unit": "USD/barrels",
        "trade_time": "(18:00(T-1) - 17:00)",
        "time_zone": "ET",
        "last_trade_time": 0,
        "exchange_format_url": "https://www.cmegroup.com/...crude-oil...",
        "delivery_type": "PHYSICAL"
      }
    ]
  }
}