Browse all documentation

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

FieldTypeMeaning
exchangesarrayOne entry for each exchange. Sorted by mic.
micstringMarket Identifier Code.
namestringEnglish name.
timezonestringIANA time zone. Session times are in this zone.
sessionsarrayThe 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.
sourcestringWhere 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

StatusCodeWhen
401invalid_api_keyThe key is missing or invalid.
402insufficient_creditsThe balance cannot pay for the call. The answer carries top_up_url.
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?