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

Name	Type	In	Required	Description
code_list	string[]	body	yes	Futures contract code list, max 400 per request; e.g. ["HK.HSImain", "US.CLmain"].

Request Example

curl -X POST 'https://webapi.moomoo.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:

Field	Type	Description
code	string	Contract code, e.g. HK.HSImain.
name	string	Contract name, e.g. HSI Futures (JUN6).
owner	string	Underlying code or commodity code (index futures use index code, commodity futures use commodity name).
exchange	string	Exchange abbreviation: HKEX / CME / CBOT / NYMEX / COMEX / CBOE / SGX / OSE.
type	string	Contract type: Equity Index / Single Stock / Metals / Energy / Agricultural / Interest Rates / Cryptocurrency / FX.
size	float	Contract size value.
size_unit	string	Contract size unit, e.g. Index Points×HKD, barrels.
price_currency	string	Quotation currency: HKD / USD / CNH / SGD / JPY.
price_unit	string	Quotation unit, e.g. Index Point, Quote*1000 USD.
min_change	float	Minimum tick size value.
min_change_unit	string	Minimum tick size unit, e.g. Index Point, USD/barrels.
trade_time	string	Trading hours, e.g. (09:15 - 12:00), (13:00 - 16:30), (17:15 - 03:00). (T-1) indicates previous trading day.
time_zone	string	Exchange timezone abbreviation: CCT / ET / CT / SGT / JST.
last_trade_time	int	Last trade time (millisecond timestamp); continuous/front-month contracts always 0.
exchange_format_url	string	Exchange contract specification page URL.
delivery_type	string	Delivery method: UNKNOWN / PHYSICAL / CASH.

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_code	error.code	Trigger Scenario	Suggested 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
-3	invalid_parameter	code_list missing / empty / exceeds 400 items	Correct parameters and retry
Other negative	internal_error	Gateway or backend internal error	Retry; if persistent, contact gateway team

Response Example

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