Skip to content

Reference Future ​

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

Get reference future contract information for a symbol.

Parameters ​

NameTypeInRequiredDescription
symbolstringpathyesSymbol 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' | jq

Response Fields ​

Returns data.reference_list[], each element is one related futures contract:

NameTypeDescription
dataobject
data.reference_listobject[]
data.reference_list[].codestringRelated futures contract code, e.g. HK.HSImain
data.reference_list[].lot_sizeintLot size (futures contract multiplier), e.g. 50
data.reference_list[].stock_typestringSecurity type, fixed to FUTURE for futures contracts
data.reference_list[].stock_namestringEnglish name
data.reference_list[].sc_namestringSimplified Chinese name
data.reference_list[].tc_namestringTraditional Chinese name
data.reference_list[].list_timeintListing time, millisecond timestamp; 0 for contracts without a listing time (e.g. index main continuous contracts)
data.reference_list[].future_validboolWhether it is a futures contract; flag indicating futures-related fields are valid, fixed true for this API
data.reference_list[].future_main_contractboolWhether it is the futures main continuous contract, e.g. true
data.reference_list[].future_last_trade_timestringFutures last trading day, format yyyy-MM-dd; empty string for main continuous contracts
paginationobjectPagination 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_codeerror.codeTrigger ScenarioSuggested Handling
0—Success; reference_list is empty [] for non-futures symbols or symbols with no related futuresTreat empty list as "this symbol has no related futures"
-3invalid_parametersymbol missing, exceeds 32 characters, or format invalidCorrect symbol format and retry
-7invalid_symbolNo 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"
      }
    ]
  }
}