Retrieve exchange holidays

Return the holiday calendar of one exchange as a single resource. Pass an exchange code from the exchanges catalog and receive the days that exchange is closed as YYYY-MM-DD dates, covering roughly 25 years of history plus the upcoming year. Combine it with the exchange trading hours to know when a market is open.

GET/v3.0.0/exchanges/holidays

Plan Access

Free

(Your plan)

Individual

$29/mo

Professional

$89/mo

Parameters

Query parameters

exchangestringrequired

Exchange code to retrieve the holiday calendar for. Check the list of available exchanges for every code.

Example: NASDAQ

Response

Response fields

idstring

Unique identifier for the holiday calendar, beginning with exh_. Derived deterministically from exchange, so it never changes for a given exchange and is safe to store in your database.

objectstring

String representing the object's type, always v3.reference.exchange_holidays for this resource.

exchangestring

Short code of the exchange this holiday calendar belongs to, e.g. NASDAQ. Matches the code field of the List exchanges endpoint.

holidaysarray of strings

Array of past and upcoming exchange holidays as YYYY-MM-DD dates, oldest first. Covers roughly 25 years of history plus the upcoming year (about 250 dates per exchange); the example above is truncated. Empty when unknown.

Related endpoints

Match the exchange field with the trading-hours resource for timezone and session context.

Request
curl "https://api.roic.ai/v3.0.0/exchanges/holidays?apikey=YOUR_API_KEY&exchange=NASDAQ"
Response
200 OK
{
  "id": "exh_DeoRWGYdYAxq6eTsV2xHqD",
  "object": "v3.reference.exchange_holidays",
  "exchange": "NASDAQ",
  "holidays": [
    "2026-01-01",
    "2026-01-19",
    "2026-02-16",
    "2026-04-03",
    "2026-05-25"
  ]
}