Skip to content

關聯期貨 ​

GET /api/v1.0/quote/{symbol}/reference-future

獲取指定標的關聯的期貨合約清單。典型用法是傳入期貨主連合約代碼(如 HK.HSImain),拿到該品種下全部相關合約(主連 / 當月 / 下月 / 各到期月份合約等)。非期貨標的或無關聯期貨時返回空 reference_list。

請求參數 ​

參數類型位置必填說明
symbolstring路徑是標的代碼,通常為期貨主連合約(如 HK.HSImain、US.CLmain、SG.NKmain)。非期貨標的合法但返回空列表。

請求示例 ​

bash
curl 'https://webapi.futunn.com/api/v1.0/quote/HK.HSImain/reference-future' | jq

響應字段 ​

返回 data.reference_list[],每元素一個關聯期貨合約:

參數類型説明
dataobject
data.reference_listobject[]
data.reference_list[].codestring關聯期貨合約代碼,例: HK.HSImain
data.reference_list[].lot_sizeint每手股數(期貨合約乘數),例: 50
data.reference_list[].stock_typestring證券類型,期貨合約固定為 FUTURE
data.reference_list[].stock_namestring英文名
data.reference_list[].sc_namestring簡體中文名
data.reference_list[].tc_namestring繁體中文名
data.reference_list[].list_timeint上市時間,毫秒時間戳;指數主連等無上市時間合約為 0
data.reference_list[].future_validbool是否期貨,期貨相關字段有效標記,本接口固定 true
data.reference_list[].future_main_contractbool是否期貨主連合約,例: true
data.reference_list[].future_last_trade_timestring期貨最後交易日,格式 yyyy-MM-dd;主連合約為空字符串
paginationobject部分接口返回分頁信息

限制範圍 ​

  • 支持的市場:HK / US / SG / JP。
  • 支持的品類:僅期貨主連合約。
  • 其他市場(AU / CA / SH / SZ / MY 等)通常無期貨品種,返回空列表。

錯誤碼 ​

ret_codeerror.code觸發場景處理建議
0—成功;非期貨標的或無關聯期貨時 reference_list 為空 []視空列表為"該標的無關聯期貨"
-3invalid_parametersymbol 缺失、超長(>32)或格式不合法校正 symbol 格式後重試
-7invalid_symbol未找到 symbol 對應的證券(未知代碼 / 退市等)確認代碼是否真實存在

響應示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "reference_list": [
      {
        "code": "HK.HSImain",
        "future_last_trade_time": "",
        "future_main_contract": true,
        "future_valid": true,
        "list_time": 0,
        "lot_size": 50,
        "stock_name": "恒指期貨主連 (2606)",
        "stock_type": "FUTURE"
      },
      {
        "code": "HK.HSI2605",
        "future_last_trade_time": "2026-05-28",
        "future_main_contract": false,
        "future_valid": true,
        "list_time": 0,
        "lot_size": 50,
        "stock_name": "恒指期貨2605",
        "stock_type": "FUTURE"
      }
    ]
  }
}