Returns a complete market status timeline for a given market over a specified time period. (The maximum time period is 31 days.)

Status values

The response will be an array of market periods. Each market period will have a start time, an end time, and a market status. The hours for each period will vary by assetType and market. The descriptions below use the U.S. equity market as an example.

Markets will usually operate on a regular cadence; however, the different market periods (status values in the table below) may vary on certain days. Examples of these edge cases include market holidays (e.g., Christmas) and certain designated "early close" days (e.g., the Friday before Labor Day). The market calendar endpoint returns the trading periods for the period requested, up to 31 days.

StatusDescription
PreMarketThe pre-market trading window. While stocks and funds are available for trading on exchanges that support it, the volume of trading is usually significantly reduced, and some assets may experience no trades during this period. Typical pre-market hours in the US are 6:00am ET until the market opens at 9:30am ET.
OpenCommonly referred to as "market hours," this period experiences the highest trading volume and is when the main exchanges are open. In the U.S., this is the period between the opening and closing bells of the NYSE and NASDAQ. Typical market hours in the U.S. are 9:30am ET until 4:00pm ET.
AfterHoursThe after-hours trading window. While stocks and funds are available for trading on exchanges which support it, the volume of trading is usually significantly reduced, and some assets may experience no trades during this period. Typical after-hours trading in the U.S. is from the market's close at 4:00pm ET until 8:00pm ET.
ClosedThe market is closed, and trading for assets in said market does not occur.

Close reasons

For periods in which the market status is "closed," a "MarketCloseReason" will also be specified, which will have one of the following values.

MarketCloseReasonExample
NORMAL_CLOSE_HOURS8:00pm - 4:00am on a regular weekday in the U.S.
WEEKEND12:00am Saturday - 11:59pm Sunday
HOLIDAYDays on which there is a full market holiday, eg. 4th July 2022 in the U.S.
LATE_OPENPeriods in which the market would usually be open, but is not yet open due to a partial holiday, eg. 10am-1pm in Brazil on 2022-03-02
EARLY_CLOSEPeriods in which the market would usually be open, but is closed early due to a partial holiday, eg. 1pm-4pm in the U.S. on Thanksgiving 2022
Ready to get started? Get your free trial API key ➔
Language
Authorization
Query
Click Try It! to start a request and see the response here!