exchange_calendars
Calendars for securities exchanges
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- 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 · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows use in commercial and private projects with minimal restrictions.
last release 2026-03-10 (157 days) · last repo commit 2026-08-14 · 662 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 7,230,240 downloads/mo, #1,765 on PyPI
Alternatives
Verify before relying
pip install exchange_calendars
import exchange_calendars as xcals
xnys = xcals.get_calendar("XNYS")
xnys.sessions_in_range("2022-01-01", "2022-01-11")- 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.
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 on this page. Verify before relying on it.
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
exchange-calendars on PyPI
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.
Requires Python 3.10 or later.
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")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 the current Python release <4,>=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 6 packagespandaspyluachtoolztzdatakorean_lunar_calendarnumpy |
| Maintenance | Actively maintained 157 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 7,230,240 / month, #1,765 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: Science/ResearchOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Scientific/EngineeringTopic :: Scientific/Engineering :: Mathematics |
Evidence: exchange_calendars-4.13.2-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “exchange trading calendars”
- exchange_calendarsProvides trading calendars for more than 50 security exchanges…
- pandas_market_calendarsProvides market and exchange trading calendars for pandas, including…
- holidaysGenerates country- and subdivision-specific government holiday…
Give your agent the search over MCP, or paste the wish link into any chat.
More Scientific/Engineering packages
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
pandas provides fast, flexible data structures (Series and DataFrame) for loading, cleaning, transforming, and analyzing labeled or relational data in Python.
scipy provides numerical algorithms for mathematics, science, and engineering—including optimization, integration, linear algebra, Fourier transforms, signal and image processing, and ODE solvers—built on numpy arrays.
scikit-learn provides a comprehensive Python library for supervised and unsupervised machine learning, including classification, regression, clustering, dimensionality reduction, and model evaluation tools built on NumPy and SciPy.
Install it if you need to train, evaluate, or deploy supervised or unsupervised learning models.
dill extends Python's pickle module to serialize and deserialize a much wider range of Python objects, including functions, lambdas, classes, and interpreter sessions, to byte streams for storage or network transmission.
Multiprocess is an enhanced fork of Python's standard multiprocessing library that uses dill for better serialization, allowing you to spawn processes with a threading-like API and share complex objects between them.
Install it if you use multiprocessing and encounter pickle serialization limits with lambdas or complex objects.
See also pandas_market_calendars · holidays · workalendar · exchangelib · tradingeconomics · convertdate · lunar_python · hdate · metatrader5 · pyCalverter