Skip to content

Future Info ​

POST /api/v1.0/quote/future-info

Get basic information for futures contracts (exchange, trade time, contract size, price unit, min change, etc.).

Parameters ​

NameTypeInRequiredDescription
code_liststring[]bodyyesFutures contract code list, max 400 per request; e.g. ["HK.HSImain", "US.CLmain"].

Request Example ​

bash
curl -X POST 'https://webapi.futunn.com/api/v1.0/quote/future-info' \
  -H 'Content-Type: application/json' \
  -d '{"code_list": ["HK.HSImain"]}' | jq

Response Fields ​

Returns data.future_info_list[], each element is one contract's info:

NameTypeDescription
dataobject
data.future_info_listobject[]
data.future_info_list[].codestringContract symbol, e.g. HK.HSImain
data.future_info_list[].namestringContract name, e.g. HSI Futures (MAY6)
data.future_info_list[].ownerstringUnderlying symbol or product code, e.g. HK.800000
data.future_info_list[].exchangestringExchange short name, e.g. HKEX / CME / SGX
data.future_info_list[].typestringContract category, e.g. Equity Index / Currency / Energy / Metals
data.future_info_list[].sizenumberContract size (numeric part), e.g. 50
data.future_info_list[].size_unitstringContract size unit, e.g. Index Points x HKD
data.future_info_list[].price_currencynumberQuote currency, e.g. HKD / USD
data.future_info_list[].price_unitstringQuote unit, e.g. Index Point
data.future_info_list[].min_changenumberMinimum tick size (numeric part), e.g. 1
data.future_info_list[].min_change_unitstringMinimum tick size unit, e.g. Index Point
data.future_info_list[].trade_timestringTrading sessions (concatenated per session of the trading day), e.g. (09:15 - 12:00), (13:00 - 16:30), (17:15 - 03:00)
data.future_info_list[].time_zoneintExchange timezone short name, e.g. CCT (China Standard Time) / EST
data.future_info_list[].last_trade_timeintLast trade time, millisecond timestamp; 0 for main/continuous contracts
data.future_info_list[].exchange_format_urlstringExchange contract specification page URL, e.g. https://www.hkex.com.hk/Products/Listed-Derivatives/Equity-Index/Hang-Seng-Index-(HSI)/Hang-Seng-Index-Futures?sc_lang=en#&product=HSI
data.future_info_list[].delivery_typestringDelivery type: UNKNOWN / PHYSICAL (physical delivery) / CASH (cash delivery)
paginationobjectPagination returned by some endpoints

Supported Markets ​

  • Supported markets: HK / US / SG / JP (covering HKEX, CME Group, SGX, OSE and other major futures exchanges).
  • Supported categories: Futures contracts only, including continuous/front-month contracts (codes ending with main) and monthly contracts (with specific year/month).
  • Unsupported inputs (stocks / ETFs / indices / options / warrants, etc.) are silently discarded; callers should compare the code field in the returned list against their input to determine which codes were not recognized.

Error Codes ​

ret_codeerror.codeTrigger ScenarioSuggested Handling
0—Success (including when all codes are silently discarded, returns empty array)Check future_info_list length, compare code field to determine which codes were not recognized
-3invalid_parametercode_list missing / empty / exceeds 400 itemsCorrect parameters and retry
Other negativeinternal_errorService errorRetry; if persistent, contact support

Response Example ​

json
{
  "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": 0,
        "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": 0,
        "last_trade_time": 0,
        "exchange_format_url": "https://www.hkex.com.hk/...HSI...",
        "delivery_type": "PHYSICAL"
      },
      {
        "code": "US.CLmain",
        "name": "Crude Oil Futures (JUL6)",
        "owner": "Crude Oil",
        "exchange": "NYMEX",
        "type": "Energy",
        "size": 1000,
        "size_unit": "barrels",
        "price_currency": 0,
        "price_unit": "Quote*1000 USD",
        "min_change": 0.01,
        "min_change_unit": "USD/barrels",
        "trade_time": "(18:00(T-1) - 17:00)",
        "time_zone": 0,
        "last_trade_time": 0,
        "exchange_format_url": "https://www.cmegroup.com/...crude-oil...",
        "delivery_type": "PHYSICAL"
      }
    ]
  }
}