Reference Future

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

Get 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

curl 'https://webapi.moomoo.com/api/v1.0/quote/HK.HSImain/reference-future' | jq

Response Fields

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

Field	Type	Description
code	string	Contract code, e.g. HK.HSImain / HK.HSI2606.
stock_name	string	Contract English name.
sc_name	string	Contract Simplified Chinese name.
tc_name	string	Contract Traditional Chinese name.
stock_type	string	Security type, fixed FUTURE for this API.
lot_size	int	Shares per lot (contract multiplier), e.g. 50.
future_valid	bool	Futures flag, fixed true for this API.
future_main_contract	bool	Whether this is a front-month/continuous contract. true=continuous; false=regular expiration contract.
future_last_trade_time	string	Last trading day, format YYYY-MM-DD; empty string "" for continuous contracts.
list_time	int	Listing time (millisecond timestamp); 0 for contracts with no listing time record.

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	symbol does not exist in security cache (unknown code / delisted, etc.)	Verify the code actually exists

Response Example

{
  "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"
      }
    ]
  }
}