Phase 1 — Live
The settlement-date API
fintech actually needs.
15 jurisdictions including NYSE/NASDAQ/LSE/JPX market calendars, UK regional subcalendars, ECB TARGET2. T+N settlement math with half-day handling. Published test suite. Primary-source citations on every holiday.
Why not just use a free API?
Market calendars, not consumer holidays
NYSE half-days, ECB TARGET2 closures, JPX year-end break — none of which show up in free public-holiday APIs.
Regional subcalendars done properly
UK Scotland vs Northern Ireland differ on Easter Monday + St Andrew's + Battle of the Boyne. German Länder vary widely. We don't roll up to "national."
T+N settlement math
POST /settlement with trade date, convention (T+1, T+2, T+3), and market code. Half-day rules built in. The competitors don't offer this at all.
Quickstart
Sign up for a free API key (no credit card), then run one of these against the live endpoint.
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://almanac.tools/v1/business-days/check?date=2026-11-26&jurisdiction=US"Our test suite is public.
200+ edge cases covering weekend cascades, computus, half-days, observed-date shifting, and cross-jurisdiction divergence — all open-sourced under CC0 at github.com/kfancy420/almanac-test-suite.
If you find a date we get wrong, file an issue. We add it as a failing test, fix the data, ship the patch.
Pricing
Self-serve only. No enterprise tier, no SLAs, no custom work. We're a small team and stay sane by keeping it simple.
Free
$0/mo
1,000 calls/month
- US federal + UK only
- /settlement endpoint not included
- /batch endpoint not included
- Custom calendars not included
- Webhook on calendar updates not included
Starter
$29/mo
50,000 calls/month
- All 15 jurisdictions
- /settlement endpoint included
- /batch endpoint included
- Custom calendars not included
- Webhook on calendar updates not included
Business
$99/mo
500,000 calls/month
- All 15 jurisdictions
- /settlement endpoint included
- /batch endpoint included
- Custom calendars included
- Webhook on calendar updates included
FAQ
Why not just use a free holiday API like Nager.Date?
Nager.Date is great for consumer holidays, but it has no market calendars (NYSE half-days, ECB TARGET2 closures), no regional subcalendars (UK Scotland vs Northern Ireland, German Länder), no settlement-date math, and no observed-date logic for cases like Jan 1 falling on Sunday. We built Almanac to fill the B2B middle.
How accurate is the data?
Every holiday entry cites a primary source (OPM, NYSE, gov.uk, ECB, Cabinet Office Japan, etc.) with a verbatim quote. We publish our test suite at github.com/kfancy420/almanac-test-suite under CC0 — 200+ edge cases including weekend cascades, computus, and cross-jurisdiction divergence. File an issue if you find a date we get wrong.
What about half-day markets?
NYSE Christmas Eve, day after Thanksgiving, day before Independence Day all close at 13:00 ET. SGX New Year's Eve and Christmas Eve close at 12:30 SGT. ASX Christmas Eve and NYE close at 13:00 AEST. We return isHalfDay: true and a closeTime field on the /check endpoint — and crucially, half-days count as trading days for /settlement T+N math.
Do you handle T+1 settlement (US equities post-May 2024)?
Yes. POST /v1/business-days/settlement takes a convention (T+0/T+1/T+2/T+3) and a market code. T+1 trades on NYSE Christmas Eve correctly settle on Dec 28 if Dec 25 is Friday and Dec 26-27 weekend.
Which jurisdictions ship at launch?
US federal, UK (England & Wales + Scotland + Northern Ireland subcalendars), Germany (federal + Bayern as regional proof), France, Switzerland, Japan (national + JPX), Canada (national + TSX), Australia (national + ASX), Singapore (national + SGX), plus market-only codes for NYSE, NASDAQ, LSE, SIX, and ECB TARGET2. Total: 15 jurisdictions. We add new jurisdictions on customer request — paid customers get priority.