Sign in
latestSwagger 2.02026-08-12187723.0 MB

c4a12725cdb5

reference_data

Market state

The market state endpoint provides real-time information on the operational status of all available stock exchanges. It returns data on whether each exchange is currently open or closed, along with the time remaining until the next opening or closing. This endpoint is useful for users who need to monitor exchange hours and plan their trading activities accordingly.

get/market_state

Query parameters

exchangestring

The exchange name where the instrument is traded.

codestring

The Market Identifier Code (MIC) of the exchange where the instrument is traded.

countrystring

The country where the exchange is located. Takes country name or alpha code.

Response

namestring required

The full name of exchange

codestring required

Market identifier code (MIC) under ISO 10383 standard

countrystring required

Country where the exchange is located

is_market_openboolean required

Indicates if the market is currently open

time_after_openstring required

Time after market opening in <code>HH:MM:SS</code> format; if currently closed - returns <code>00:00:00</code>

time_to_openstring required

Time to market opening in <code>HH:MM:SS</code> format; if currently open - returns <code>00:00:00</code>

time_to_closestring required

Time to market closing in <code>HH:MM:SS</code> format; if currently closed - returns <code>00:00:00</code>

Example response

[
  {
    "name": "NYSE",
    "code": "XNYS",
    "country": "United States",
    "is_market_open": true,
    "time_after_open": "02:39:03",
    "time_to_open": "00:00:00",
    "time_to_close": "05:20:57"
  }
]