---
title: Stock Exchange Calendars API
slug: stock-exchange-calendars-api
url: https://apyhub.com/callable-labs/service/stock-exchange-calendars-api
provider: Callable Labs
categories: [Finance, Standard Data]
tags: [stock-exchanges, market-calendar, mic-codes, finance]
auth: api_key
version: 0.1.0
service_type: sync
endpoints: 3
atoms: 5
mcp: true
---

# Stock Exchange Calendars API

List supported stock exchanges and get calendar details for any MIC code or acronym: holiday categories, weekend days, covered years and subdivisions.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/callable-labs/stock-exchange-calendars-api/v1/markets` | What it does Lists every stock and financial exchange that has a market-holiday calendar, with its… | 5 |
| GET | `https://api.eu.apyhub.com/callable-labs/stock-exchange-calendars-api/v1/markets/:market` | What it does Returns the details of one stock exchange: its holiday categories (public closures and… | 5 |
| GET | `https://api.eu.apyhub.com/callable-labs/stock-exchange-calendars-api/v1/market-holidays/:year/:market` | What it does Returns the days an exchange is closed in a given year (NYSE, NASDAQ, LSE, TARGET2, JP… | 5 |

## Endpoint reference

### List Stock Exchanges

`GET https://api.eu.apyhub.com/callable-labs/stock-exchange-calendars-api/v1/markets` · 5 atoms · accepts `application/json` · returns `application/json`

#### Quickstart

List every stock exchange that has a market-holiday calendar.

```bash
curl -X GET "https://api.eu.apyhub.com/callable-labs/stock-exchange-calendars-api/v1/markets" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with `count`, the number of exchanges, `calendar_version`, and an `items` array with one object per exchange: its MIC `code`, `aliases`, `name`, holiday `categories`, `weekend` days and the `years` covered. Only the first exchange is shown here.

```json
{
  "count": 28,
  "calendar_version": "2026.10",
  "items": [
    {
      "code": "XNYS",
      "aliases": ["NYSE"],
      "name": "New York Stock Exchange",
      "kind": "market",
      "categories": ["public", "half_day"],
      "default_category": "public",
      "languages": ["en"],
      "default_language": "en",
      "weekend": ["saturday", "sunday"],
      "subdivision_count": 0,
      "years": [2000, 2100]
    }
  ]
}
```

### Get Stock Exchange Details

`GET https://api.eu.apyhub.com/callable-labs/stock-exchange-calendars-api/v1/markets/:market` · 5 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `market` | path | string | yes | Exchange MIC or acronym Default: `XNYS`. Example: `XNYS`. |

#### Quickstart

Get the calendar details of the New York Stock Exchange by its MIC code.

```bash
curl -X GET "https://api.eu.apyhub.com/callable-labs/stock-exchange-calendars-api/v1/markets/:market" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object describing the exchange: its `code`, `aliases`, `name`, holiday `categories` and `default_category`, `languages`, `weekend` days, `subdivisions` and the `years` covered.

```json
{
  "code": "XNYS",
  "aliases": [
    "NYSE"
  ],
  "name": "New York Stock Exchange",
  "kind": "market",
  "categories": [
    "half_day",
    "public"
  ],
  "default_category": "public",
  "languages": [
    "en_US",
    "gu",
    "hi"
  ],
  "default_language": "en_US",
  "weekend": [
    "saturday",
    "sunday"
  ],
  "subdivision_count": 0,
  "years": [
    1900,
    2100
  ],
  "subdivisions": []
}
```

### List Stock Market Holidays by Year

`GET https://api.eu.apyhub.com/callable-labs/stock-exchange-calendars-api/v1/market-holidays/:year/:market` · 5 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `year` | path | integer | yes | Year, 1900–2100 Default: `2026`. Example: `2026`. |
| `market` | path | string | yes | Exchange MIC or acronym Default: `XNYS`. Example: `XNYS`. |
| `language` | query | string | no | Language for `name`, e.g. `en_US`, `de`, `fr`. Default: English when available. |
| `observed` | query | boolean | no | Include days off moved by observance rules (e.g. a Sunday holiday observed on Monday) Default: `true`. |
| `categories` | query | string | no | Comma-separated holiday categories, e.g. `public,bank`. Default: the calendar's main category (usually `public`). |
| `subdivision` | query | string | no | Subdivision code or name, e.g. `CA`, `BY` or `Bayern` (names as the calendar knows them) |

#### Quickstart

List the days the New York Stock Exchange is closed in 2026.

```bash
curl -X GET "https://api.eu.apyhub.com/callable-labs/stock-exchange-calendars-api/v1/market-holidays/:year/:market" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with the `year`, the `count` of closures and a `holidays` array sorted by date. Each entry has its `date`, `weekday`, `name`, `local_name`, `categories` and an `observed` flag. Add `categories=half_day` to list early closes instead. Only the first closures are shown here.

```json
{
  "year": 2026,
  "count": 10,
  "market": "XNYS",
  "categories": ["public"],
  "language": "en",
  "calendar_version": "2026.10",
  "holidays": [
    {
      "date": "2026-01-01",
      "weekday": "thursday",
      "name": "New Year's Day",
      "local_name": "New Year's Day",
      "categories": ["public"],
      "observed": false
    },
    {
      "date": "2026-01-19",
      "weekday": "monday",
      "name": "Martin Luther King Jr. Day",
      "local_name": "Martin Luther King Jr. Day",
      "categories": ["public"],
      "observed": false
    }
  ]
}
```

## About

## What it does
Stock Exchange Calendars lists the stock and financial exchanges that have a market-holiday calendar and returns the details of each one. Look up an exchange by its MIC code or acronym, such as `XNYS` or `NYSE`.

`GET /v1/markets` returns every supported exchange with its MIC code, aliases and name. `GET /v1/markets/:market` returns one exchange with its holiday categories (`public` closures and `half_day` early closes), default category, languages, weekend days, subdivisions and the years covered.

Use the results to find the exact code to pass to the other holiday and business-day endpoints, to show which exchanges your app supports, or to check how far ahead an exchange calendar goes before you request its holidays.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/callable-labs/service/stock-exchange-calendars-api