---
title: "Exchange status API | Narwhal API"
description: "Whether an exchange is open at an instant, for one MIC or all exchanges: status, session, reason, close time and next open. Parameters, fields and errors."
url: "https://narwhalapi.com/docs/api/calendars/exchange-status"
---

# 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

| 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.

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

| Field | Type | Meaning |
| --- | --- | --- |
| `mic / name / timezone` | 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_type` | 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_key` | string | The key of the closure on that local date, as the closures route serves it. null when there is none. |
| `closes_at` | 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_open_at` | 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 /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

| Status | Code | When |
| --- | --- | --- |
| 400 | `invalid_query` | 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_api_key` | The key is missing or invalid. |
| 402 | `insufficient_credits` | 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_limit_exceeded` | The per-minute limit is reached. |
| 503 | `database_unavailable` | 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](https://narwhalapi.com/docs/errors.md)
[Exchange closures](https://narwhalapi.com/docs/api/calendars/exchange-closures.md) · [Public holidays reference](https://narwhalapi.com/docs/api/calendars.md)

Was this page helpful?
