---
id: exchange-calendars
version: "4.13.2"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# exchange_calendars — Calendars for securities exchanges

License: permissive · Maintenance: active · Downloads: 7.2M/mo

## What it is and what it does

exchange_calendars is a Python library that bundles pre-configured trading calendars for security exchanges worldwide. It abstracts away the complexity of managing exchange-specific holidays, trading hours, and timezone conversions by providing a unified API to query whether a given date or minute is a trading session, retrieve trading schedules with open/close times and breaks, and generate time indices aligned to exchange sessions.

The library depends on pandas for data structures, numpy for numerical operations, tzdata for timezone handling, and specialized libraries for lunar calendar calculations (used by exchanges that observe lunar holidays). It exposes calendars through a simple interface: load a calendar by exchange code, then call methods like `is_session()`, `sessions_in_range()`, `session_minutes()`, or `trading_index()` to get the information you need. A command-line tool is also included for quick calendar visualization.

Use it for:

- Validate whether a timestamp falls within trading hours before executing a trade or backtest.
- Generate a list of all trading days in a date range for a specific exchange to align analysis windows.
- Build minute-level trading indices with custom period lengths (e.g., 90-minute bars) for intraday analysis.
- Determine the next or previous trading session from a given date for scheduling or reconciliation tasks.
- Query exchange schedules including breaks and early closes to understand market microstructure.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides trading calendars for more than 50 security exchanges worldwide, allowing you to query trading sessions, minutes, and schedules with timezone-aware timestamps and holiday handling.

Yes. The package is actively maintained, has no known vulnerabilities, uses a permissive license, and solves a real problem in quantitative finance and trading systems—managing exchange calendars is tedious and error-prone without it. Install it if you work with multiple exchanges or need reliable session/minute-level time alignment.

## Install

pip install exchange-calendars
uv add exchange-calendars
poetry add exchange-calendars

## Installing exchange_calendars

Before you install: Low install friction with six well-established runtime dependencies (pandas, numpy, toolz, tzdata, and two lunar calendar libraries). Active maintenance with a recent release and steady commit history.

License in practice: Apache-2.0 permissive license allows use in commercial and private projects with minimal restrictions.

Quickstart:

pip install exchange_calendars

import exchange_calendars as xcals
xnys = xcals.get_calendar("XNYS")
xnys.sessions_in_range("2022-01-01", "2022-01-11")

Requires Python 3.10 or later.

Verify before relying:

- Whether all 50+ exchange calendars are actively maintained and current with recent holiday/schedule changes.
- Performance characteristics when querying large date ranges or generating minute-level trading indices.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 7.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

exchange trading calendars, stock market session times, trading hours by exchange, financial calendar library, securities exchange schedules, market open close times, trading day queries, finance, trading, time-series

[View on SkillFed](https://skillfed.io/packages/exchange-calendars) · [View on PyPI](https://pypi.org/project/exchange-calendars/)