Skip to content
MarketCalendars.com
Sign up

API documentation

REST API v2: trading hours, holidays and settlement days as JSON over HTTPS

Get a market's status now

GET/api/v2/markets/{market}/status

Whether the market is open now, the current phase, the next change and the trade date of the current or next session

One request: now. A successful response counts as one request

Parameters

NameInDescription
marketrequiredpathMarket id, as listed by GET /markets (for example nyse, lse, cme-equity-futures)Example: nyse

Example

curl https://marketcalendars.com/api/v2/markets/nyse/status \
  -H "Authorization: Bearer mc_live_..."
GET /api/v2/markets/nyse/status200
{
  "market": "nyse",
  "asOf": "2026-10-26T15:12:14+00:00",
  "timezone": "America/New_York",
  "localTime": "2026-10-26T11:12:14-04:00",
  "isOpen": true,
  "phase": "regular",
  "tradeDate": "2026-10-26",
  "nextChange": {
    "at": "2026-10-26T16:00:00-04:00",
    "phase": "after_hours"
  },
  "nextOpen": "2026-10-27T09:30:00-04:00",
  "nextClose": "2026-10-26T16:00:00-04:00"
}

A live response from the API. Lists longer than seven items are cut to three here

Response fields

Status object. Fields marked | null are always present and may be null

FieldTypeDescription
marketstringMarket id
asOfstring (date-time)Moment the status was computed, UTC
timezonestringIANA time zone of the market
localTimestring (date-time)Current time in the market's time zone
isOpenbooleanTrue during regular trading only
phasestringCurrent phase. unknown means the moment is outside our datapre_marketregularbreakafter_hoursclosedunknown
tradeDatestring (date) | nullTrade date of the current phase, or of the next session when closed
nextChangeobject | nullNext phase change. Null when none is known within 40 days, or the market trades around the clock
nextChange.atstring (date-time)When the current phase ends
nextChange.phasestringCurrent phase. unknown means the moment is outside our datapre_marketregularbreakafter_hoursclosedunknown
nextOpenstring (date-time) | nullNext start of regular trading
nextClosestring (date-time) | nullEnd of the current or next regular session

Errors

  • 401unauthorizedThe Authorization header is missing, malformed, or names a revoked key
  • 404unknown-marketNo market has that id. GET /markets lists every id
  • 429rate-limitedThe key sent more requests in a minute than its plan's burst limit
  • 429quota-exceededThe plan's requests for this period are used up