關聯期貨
GET/api/v1.0/quote/{symbol}/reference-future獲取指定標的關聯的期貨合約清單。典型用法是傳入期貨主連合約代碼(如 HK.HSImain),拿到該品種下全部相關合約(主連 / 當月 / 下月 / 各到期月份合約等)。非期貨標的或無關聯期貨時返回空 reference_list。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
symbol | string | 路徑 | 是 | 標的代碼,通常為期貨主連合約(如 HK.HSImain、US.CLmain、SG.NKmain)。非期貨標的合法但返回空列表。 |
請求示例
bash
curl 'https://webapi.futunn.com/api/v1.0/quote/HK.HSImain/reference-future' | jq響應字段
返回 data.reference_list[],每元素一個關聯期貨合約:
| 參數 | 類型 | 説明 |
|---|---|---|
data | object | |
data.reference_list | object[] | |
data.reference_list[].code | string | 關聯期貨合約代碼,例: HK.HSImain |
data.reference_list[].lot_size | int | 每手股數(期貨合約乘數),例: 50 |
data.reference_list[].stock_type | string | 證券類型,期貨合約固定為 FUTURE |
data.reference_list[].stock_name | string | 英文名 |
data.reference_list[].sc_name | string | 簡體中文名 |
data.reference_list[].tc_name | string | 繁體中文名 |
data.reference_list[].list_time | int | 上市時間,毫秒時間戳;指數主連等無上市時間合約為 0 |
data.reference_list[].future_valid | bool | 是否期貨,期貨相關字段有效標記,本接口固定 true |
data.reference_list[].future_main_contract | bool | 是否期貨主連合約,例: true |
data.reference_list[].future_last_trade_time | string | 期貨最後交易日,格式 yyyy-MM-dd;主連合約為空字符串 |
pagination | object | 部分接口返回分頁信息 |
限制範圍
- 支持的市場:HK / US / SG / JP。
- 支持的品類:僅期貨主連合約。
- 其他市場(AU / CA / SH / SZ / MY 等)通常無期貨品種,返回空列表。
錯誤碼
| ret_code | error.code | 觸發場景 | 處理建議 |
|---|---|---|---|
| 0 | — | 成功;非期貨標的或無關聯期貨時 reference_list 為空 [] | 視空列表為"該標的無關聯期貨" |
| -3 | invalid_parameter | symbol 缺失、超長(>32)或格式不合法 | 校正 symbol 格式後重試 |
| -7 | invalid_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"
}
]
}
}