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.
| Status | Description |
|---|---|
| PreMarket | The 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. |
| Open | Commonly 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. |
| AfterHours | The 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. |
| Closed | The 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.
| MarketCloseReason | Example |
|---|---|
| NORMAL_CLOSE_HOURS | 8:00pm - 4:00am on a regular weekday in the U.S. |
| WEEKEND | 12:00am Saturday - 11:59pm Sunday |
| HOLIDAY | Days on which there is a full market holiday, eg. 4th July 2022 in the U.S. |
| LATE_OPEN | Periods 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_CLOSE | Periods 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 |