Browse all documentation

Exchange status API reference

Whether an exchange is open at an instant, for one exchange or all of them.

Request

GET /v1/calendars/exchanges/status 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.

Is the New York Stock Exchange open at 15:00 UTC on 27 November 2026
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

NameTypeRule
micstringOptional. 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.
atstringOptional. 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.

200 OK
{
  "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_key says which day.

A holiday
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"
200 OK
{
  "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

FieldTypeMeaning
mic / name / timezonestringThe exchange, its English name and its IANA time zone.
atstringThe instant checked, UTC, in whole seconds.
statusstringopen only while the regular session runs. closed otherwise, pre-market and after-hours trading included.
day_typestringThe day's type from the closures route: full, early_close or late_open. regular when the calendar has no entry for that local date.
sessionstringpre_market, regular or after_hours while one of those windows runs. null otherwise.
reasonstringWhy a closed exchange is closed: weekend, holiday, before_open, after_close or lunch. null when open.
holiday_keystringThe key of the closure on that local date, as the closures route serves it. null when there is none.
closes_atstringWhen 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_open_atstringThe next start of a regular trading window after at, UTC; the end of a midday break counts. null when none starts within 30 days.
sourcestringWhere the answer comes from.

Matching MCP call

Send an authenticated POST /mcp with Accept: application/json, text/event-stream. The tool is calendars_get_exchange_status.

{
  "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

StatusCodeWhen
400invalid_queryThe 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.
401invalid_api_keyThe key is missing or invalid.
402insufficient_creditsThe balance cannot pay for the call. The answer carries top_up_url.
404not_foundNo calendar is published for the MIC. Not charged.
429rate_limit_exceededThe per-minute limit is reached.
503database_unavailableThe 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

Exchange closures · Public holidays reference

Was this page helpful?