Built on the holidays library, for when a list isn't enough
Checked against the holidays library's public pages on Tue 13 Oct 2026.
What the holidays library does well
- Free and open source under the MIT licence, with an active community.
- Rules for about 250 countries and territories and many subdivisions, plus financial markets such as the NYSE and the ECB's TARGET2.
- Runs in your own process: no network call and no rate limit.
What the library is
The holidays library is an open-source Python package with the holiday rules of about 250 countries and territories and many subdivisions. It’s free under the MIT licence and maintained by a large community of contributors. Every country calendar in this API comes from it, and we’re grateful for that work.
What the API adds
- Settlement calendars. Payment systems such as Fedwire, TARGET2 and CHAPS follow their own rules, which differ from public holidays. These are curated separately, and each verified year is checked against the central bank’s own calendar.
- A source for each verified date. Verified years cite the official notice they were checked against, with an archived copy.
- Business-day maths across calendars. T+N, counts and checks across up to 10 calendars in one request.
- A changes feed listing every date each release added, removed or modified.
- Any language. It’s an HTTP API, so it works from JavaScript, Excel, Go or a cron job, not only Python.
| Feature | Finance Calendar API | the holidays library |
|---|---|---|
| Country and regional holidays | 1,597 countries and regions, from the library | Yes: the source of this data |
| Settlement-system calendars (Fedwire, CHAPS…) | 17 settlement systems, curated per central bank | TARGET2, as the ECB calendar; Fedwire, CHAPS and others not listed |
| Early closes with their times | Yes, for exchanges | Half days marked for some markets, without close times |
| Checked against official sources | Verified years cite their sources, with archived copies | Community-maintained rules, no per-date source |
| Several calendars combined | Business-day maths across up to 10 calendars | Combine them in your own code |
| Tracking changes | A changes feed per data release | Read the changelog between versions |
| How you use it | An HTTP request, from any language or a spreadsheet | A Python package |
| Price | From US$29/month, 14-day free trial | Free (MIT) |
Spotted something out of date? This comparison reflects the holidays library's public pages on Tue 13 Oct 2026.
Questions
Should I use the library instead?
If you write Python, need public holidays for a handful of countries and don't need a cited source for each date, use the library directly. It's excellent, and it runs in your own process. Use the API when you need settlement calendars, early-close times, several calendars combined, a source per date, or a language other than Python.
Try it free for 14 days
Start a 14-day free trial and make your first request in minutes.