Market Calendar

GET /api/calendar/exchange

Is an exchange open on a given date, or right now? Returns the session open/close (local exchange time and UTC), lunch breaks, early closes / late opens, the holiday name when closed, and the previous/next trading days. Omit date for live status (is_open_now, next_open_utc, next_close_utc, evaluated in the exchange's own timezone). Computed from the open-source exchange_calendars rule set - reference only. Every answer carries holiday_data_available, holiday_data_available_through (the last date with published holiday data; null = rule-based calendar with no fixed end) and warning. A few exchanges with lunar-calendar holidays (e.g. XSHG, XBOM, XSES) only have holiday data to a fixed date (see /api/calendar/exchanges); for a date AFTER it the endpoint still answers, best-effort: weekdays are treated as trading days with the exchange's regular session times (incl. lunch breaks), weekends as closed, dates the exchange closed on a weekday in each of the previous two years (fixed-date holidays such as 1 January) as closed; other public holidays (e.g. lunar-calendar ones) and early closes are NOT known, holiday_data_available is false and warning explains. The same applies to is_open_now / next_open_utc / next_close_utc. Pro subscription required.

Request

Query parameters

api_keystring required

API key for authentication (Pro tier required)

micstring required

ISO 10383 market identifier, e.g. XNYS (NYSE), XLON (LSE), XTKS (Tokyo), XHKG (Hong Kong). See /api/calendar/exchanges.

datestring

Date in YYYY-MM-DD (optional). Omit for today's schedule plus live open/closed status. Supported range is roughly the last 20 years to the end of next year.

format'json' | 'xml'
callbackstring

JSONP callback name (optional, json only).

Response

Exchange schedule for the date.

Changes

No recorded changes to this operation across all 1 revision of this API.