Data quality
How we verify our holiday data
A wrong holiday means a late payment, a failed settlement or a wrong cash flow. So every one of our 319 calendars is built from official sources, computed from the rules in law, and checked again on a schedule. Here is how.
1. Official sources first
Each calendar is checked against the dated, official list of its own issuer: the central bank, the payment system operator, the exchange or the government gazette. We do not use Wikipedia, blogs or another company's list as a source.
- The right book: a stock exchange is checked against its cash market notice, not its derivatives schedule.
- The right issuer: euro payments follow TARGET2, not the public holidays of one euro country.
2. Rules, not copied lists
Recurring holidays are computed from the rule in law, so every year follows the same logic. That is how our calendars reach 2077.
- Fixed dates and weekday rules, such as the fourth Thursday of November.
- Easter-based holidays.
- Islamic, Chinese, Hindu and Buddhist calendars, and solar terms.
- What happens when a holiday falls on a weekend, market by market.
3. Every exception, with its source
Some closures follow no rule: a day of mourning, an election, a bridge day set by decree, a one-off market closure. Each one is stored with a link to the official notice that announced it.
4. Weekends and half days
Not every market rests on Saturday and Sunday, and some have changed. We record each market's weekend, including past changes, and the weekend days that become working days.
- Saudi Arabia: Friday and Saturday since June 2013.
- UAE: Saturday and Sunday since January 2022.
- China: make-up working days on weekends around long holidays.
- Early closes keep their local closing time and stay business days.
5. Estimated until confirmed
Holidays set by the moon or by a yearly decree cannot be known for sure years ahead. We mark them as estimated until an official source confirms them. Every date in the API carries an is_estimated field, so your systems can tell.
6. A documented review for every calendar
Before a calendar is published, it goes through a written review: its source, how it builds on other calendars, its rules, the generated dates, and a date-by-date comparison with the official list and independent sources. Every difference must be explained. Any fix is checked again before it goes live.
7. Kept up to date
Holiday lists change after they are published. These checks run on a fixed schedule.
| Every week | We check whether governments, central banks and exchanges have published next year's holiday lists. |
|---|---|
| Every week | We scan official announcements for exceptional closures in the next 90 days. |
| Every month | We check whether official lists have changed since our last review. |
| Every month | Full review of the major markets. |
| Every 3 or 6 months | Full review of every other calendar. |
8. You see every change
- Every added, moved or confirmed date is listed in our calendar updates, with its official source.
- Subscribers to calendar updates get an email when a date changes.
- Found a wrong date? Tell us. We check it against the official source and fix it.
Questions
Our weekly checks look for these announcements. When one is found, the calendars it affects are reviewed and updated with a link to the official notice. The change is listed in our calendar updates, and subscribers get an email.
See the data for yourself
Browse every calendar on the coverage page, or try the API free: 10 calls a day, no card.