Reference Future
GET/api/v1.0/quote/{symbol}/reference-futureGet reference future contract information for a symbol.
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
symbol | string | path | yes | Symbol code, typically a futures front-month/continuous contract (e.g. HK.HSImain, US.CLmain, SG.NKmain). Non-futures symbols are valid but return an empty list. |
Request Example
bash
curl 'https://webapi.futunn.com/api/v1.0/quote/HK.HSImain/reference-future' | jqResponse Fields
Returns data.reference_list[], each element is one related futures contract:
| Name | Type | Description |
|---|---|---|
data | object | |
data.reference_list | object[] | |
data.reference_list[].code | string | Related futures contract code, e.g. HK.HSImain |
data.reference_list[].lot_size | int | Lot size (futures contract multiplier), e.g. 50 |
data.reference_list[].stock_type | string | Security type, fixed to FUTURE for futures contracts |
data.reference_list[].stock_name | string | English name |
data.reference_list[].sc_name | string | Simplified Chinese name |
data.reference_list[].tc_name | string | Traditional Chinese name |
data.reference_list[].list_time | int | Listing time, millisecond timestamp; 0 for contracts without a listing time (e.g. index main continuous contracts) |
data.reference_list[].future_valid | bool | Whether it is a futures contract; flag indicating futures-related fields are valid, fixed true for this API |
data.reference_list[].future_main_contract | bool | Whether it is the futures main continuous contract, e.g. true |
data.reference_list[].future_last_trade_time | string | Futures last trading day, format yyyy-MM-dd; empty string for main continuous contracts |
pagination | object | Pagination returned by some endpoints |
Supported Markets
- Supported markets: HK / US / SG / JP.
- Supported categories: Futures front-month/continuous contracts only.
- Other markets (AU / CA / SH / SZ / MY, etc.) typically have no futures products, returns empty list.
Error Codes
| ret_code | error.code | Trigger Scenario | Suggested Handling |
|---|---|---|---|
| 0 | — | Success; reference_list is empty [] for non-futures symbols or symbols with no related futures | Treat empty list as "this symbol has no related futures" |
| -3 | invalid_parameter | symbol missing, exceeds 32 characters, or format invalid | Correct symbol format and retry |
| -7 | invalid_symbol | No security matches symbol (unknown code / delisted, etc.) | Verify the code actually exists |
Response Example
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"
}
]
}
}