Exchange status API reference
Whether an exchange is open at an instant, for one exchange or all of them.
Request
GET / says whether an exchange's regular session is open at an instant. Send mic for one exchange, or leave it out for every exchange in the list. Use your Narwhal bearer key.
curl --request GET \
--url "https://api.narwhalapi.com/v1/calendars/exchanges/status?mic=XNYS&at=2026-11-27T15:00:00Z" \
--header "Authorization: Bearer $NARWHAL_API_KEY"Parameters
| Name | Type | Rule |
|---|---|---|
mic | string | Optional. Market Identifier Code, four uppercase letters or digits, such as XNYS. Left out, the answer lists every exchange in the exchange list. An unknown code returns 404. |
at | string | Optional. The instant to check, RFC 3339 with a UTC offset such as Z or +07:00, from the year 2000 to 2100. Left out, now. |
There is no pagination. An unknown query parameter is ignored.
Response
With mic the answer is one object. 27 November 2026 is the early-close day after Thanksgiving, and 15:00 UTC is 10:00 in New York, so the exchange is open until 18:00 UTC.
{
"mic": "XNYS",
"name": "New York Stock Exchange",
"timezone": "America/New_York",
"at": "2026-11-27T15:00:00Z",
"status": "open",
"day_type": "early_close",
"session": "regular",
"reason": null,
"holiday_key": "day_after_thanksgiving",
"closes_at": "2026-11-27T18:00:00Z",
"next_open_at": "2026-11-30T14:30:00Z",
"source": "Narwhal exchange calendar"
}On Thanksgiving Day the exchange is closed for the whole day and holiday_ says which day.
curl --request GET \
--url "https://api.narwhalapi.com/v1/calendars/exchanges/status?mic=XNYS&at=2026-11-26T15:00:00Z" \
--header "Authorization: Bearer $NARWHAL_API_KEY"{
"mic": "XNYS",
"name": "New York Stock Exchange",
"timezone": "America/New_York",
"at": "2026-11-26T15:00:00Z",
"status": "closed",
"day_type": "full",
"session": null,
"reason": "holiday",
"holiday_key": "thanksgiving_day",
"closes_at": null,
"next_open_at": "2026-11-27T14:30:00Z",
"source": "Narwhal exchange calendar"
}Without mic the answer is { exchanges, source }, and each entry has the fields below, sorted by MIC.
Fields
| Field | Type | Meaning |
|---|---|---|
mic / | string | The exchange, its English name and its IANA time zone. |
at | string | The instant checked, UTC, in whole seconds. |
status | string | open only while the regular session runs. closed otherwise, pre-market and after-hours trading included. |
day_ | string | The day's type from the closures route: full, early_close or late_open. regular when the calendar has no entry for that local date. |
session | string | pre_market, regular or after_hours while one of those windows runs. null otherwise. |
reason | string | Why a closed exchange is closed: weekend, holiday, before_open, after_close or lunch. null when open. |
holiday_ | string | The key of the closure on that local date, as the closures route serves it. null when there is none. |
closes_ | string | When today's regular session ends, UTC. An early close shows its early time. null once it has ended or on a day with no session. |
next_ | string | The next start of a regular trading window after at, UTC; the end of a midday break counts. null when none starts within 30 days. |
source | string | Where the answer comes from. |
Matching MCP call
Send an authenticated POST / with Accept: application/. The tool is calendars_.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "calendars_get_exchange_status",
"arguments": {
"mic": "XNYS",
"at": "2026-11-27T15:00:00Z"
}
}
}Successful results have isError: false, the same response in structuredContent, and serialized JSON in content[0].text. Domain errors have isError: true.
Errors and credits
| Status | Code | When |
|---|---|---|
| 400 | invalid_ | The MIC is not four uppercase letters or digits, or at is not an RFC 3339 time with an offset in the years 2000 to 2100. |
| 401 | invalid_ | The key is missing or invalid. |
| 402 | insufficient_ | The balance cannot pay for the call. The answer carries top_up_url. |
| 404 | not_found | No calendar is published for the MIC. Not charged. |
| 429 | rate_ | The per-minute limit is reached. |
| 503 | database_ | The data store is temporarily unavailable. Retry shortly. |
A successful request costs one call on the Calendars API code, $2 per 1,000 calls. Errors cost nothing. Shared error details
Was this page helpful?