Skip to content

Market State ​

POST /api/v1.0/quote/market-state

Get the current market state (open / closed / pre-market / after-hours / overnight / closing auction, etc.) for a batch of symbols. Useful for determining quote availability and freshness.

Parameters ​

NameTypeInRequiredDescription
code_liststring[]bodyyesList of symbol codes in {market}.{code} format, e.g. ["HK.00700","US.AAPL","SH.600519"]. Market prefix is required. Max 400 per batch.
is_contain_baboolbodynoWhether to include US pre-market/after-hours sessions; true switches trade_section to the next trading day's schedule once pre/after-hours begins. Default false. Only affects US-related entries.
is_contain_overnightboolbodynoWhether to include US overnight session; true switches trade_section to the next trading day's schedule once overnight begins. Default false. Only affects US-related entries.
is_need_crypto_multi_brokerboolbodynoWhether to return multi-broker data for crypto market; true expands multiple records per market_id by broker. Default false. Only affects CC. prefix entries.

Request Example ​

bash
curl -X POST 'https://webapi.futunn.com/api/v1.0/quote/market-state' \
  -H 'Content-Type: application/json' \
  -d '{"code_list":["HK.00700","US.AAPL","SH.600519","SZ.000001"]}' | jq

Response Fields ​

Returns data.market_state_list[], with elements as follows.

NameTypeDescription
dataobject
data.market_state_listobject[]
data.market_state_list[].codestring
data.market_state_list[].stock_namestring
data.market_state_list[].sc_namestring
data.market_state_list[].tc_namestring
data.market_state_list[].market_statestring
data.market_state_list[].time_dateint
data.market_state_list[].traded_secondsstring
data.market_state_list[].total_secondsstring
data.market_state_list[].trade_sectionstring
data.market_state_list[].broker_idint
data.market_state_list[].broker_idsstring
paginationobjectPagination returned by some endpoints

Supported Markets ​

  • Code must use a supported market prefix from the 12 markets listed below; otherwise returns invalid_symbol: HK (Hong Kong) / US (United States) / SH (Shanghai A-shares) / SZ (Shenzhen A-shares) / BJ (Beijing Stock Exchange) / SG (Singapore) / JP (Japan) / KR (Korea) / CA (Canada) / AU (Australia) / SH_FX (Shanghai-Shenzhen FX) / CC (Crypto).
  • Unsupported market prefixes (not limited to): DE Germany, FR France, GB UK, MY Malaysia, TH Thailand, ID Indonesia, VN Vietnam, NZ New Zealand, NL Netherlands, PT Portugal, IT Italy.
  • For unsupported markets: the corresponding entry retains the requested code, market_state returns "NONE", extended fields are omitted; does not affect other valid symbols in the same batch.
  • Max code_list length is 400; exceeding or empty array returns invalid_parameter.
  • Market prefix is required; missing prefix (e.g. "00700") triggers invalid_parameter.

Error Codes ​

ret_codeerror.codeTrigger ConditionRecommended Action
0—Success, data.market_state_list length equals request code_list lengthIterate market_state_list, match by code to your requested symbols
-3invalid_parametercode_list missing / element type not string / list empty / length exceeds 400 / element missing market prefixFix request body, ensure {market}.{code} format
-5backend_biz_errorBusiness error; see the response message for detailsRead error.message for details; may retry
-2 / -4 / -6internal_errorService errorRetain x-trace-id and report to support

Response Example ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "market_state_list": [
      {
        "code": "HK.00700",
        "market_state": "AFTERNOON",
        "stock_name": "腾讯控股"
      },
      {
        "code": "US.AAPL",
        "market_state": "AFTER_HOURS_END",
        "stock_name": "苹果"
      },
      {
        "code": "SH.600519",
        "market_state": "AFTERNOON",
        "stock_name": "贵州茅台"
      },
      {
        "code": "SZ.000001",
        "market_state": "AFTERNOON",
        "stock_name": "平安银行"
      }
    ]
  }
}