---
title: "Exchange list API | Narwhal API"
description: "Every exchange with a published calendar, with its MIC, time zone and trading sessions. Fields, errors and credits."
url: "https://narwhalapi.com/docs/api/calendars/exchange-list"
---

# Exchange list API reference

Every exchange with a published calendar, with its time zone and trading sessions.

## Request

`GET /v1/calendars/exchanges` lists every exchange with a published calendar: its MIC, name, time zone and the trading windows of a normal day. Use your Narwhal bearer key.

List the exchanges

```
curl --request GET \
  --url "https://api.narwhalapi.com/v1/calendars/exchanges" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
```

## Parameters

None. There is no pagination and no filter. An unknown query parameter is ignored.

## Response

The answer holds every exchange, sorted by MIC. This answer is trimmed to one exchange. Use each MIC with the status route and the closures route.

200 OK

```
{
  "exchanges": [
    {
      "mic": "XNYS",
      "name": "New York Stock Exchange",
      "timezone": "America/New_York",
      "sessions": [
        {
          "name": "Pre-market",
          "opens_at": "04:00",
          "closes_at": "09:30",
          "valid_from": "2026-01-01"
        },
        {
          "name": "Regular",
          "opens_at": "09:30",
          "closes_at": "16:00",
          "valid_from": "2026-01-01"
        },
        {
          "name": "After-hours",
          "opens_at": "16:00",
          "closes_at": "20:00",
          "valid_from": "2026-01-01"
        }
      ]
    }
  ],
  "source": "Narwhal exchange calendar"
}
```

## Fields

| Field | Type | Meaning |
| --- | --- | --- |
| `exchanges` | array | One entry for each exchange. Sorted by mic. |
| `mic` | string | Market Identifier Code. |
| `name` | string | English name. |
| `timezone` | string | IANA time zone. Session times are in this zone. |
| `sessions` | array | The trading windows of a normal day: name, opens_at and closes_at as local HH:MM, and valid_from, the date the window starts to apply. Can be empty. |
| `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_list_exchanges`.

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "calendars_list_exchanges",
    "arguments": {}
  }
}
```

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