Exchange list API reference
Every exchange with a published calendar, with its time zone and trading sessions.
Request
GET / 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.
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.
{
"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 / with Accept: application/. The tool is calendars_.
{
"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_ | The key is missing or invalid. |
| 402 | insufficient_ | The balance cannot pay for the call. The answer carries top_up_url. |
| 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?