Market Holidays & Trading Hours API
For Financial Applications

TradingHours.com created the "FinID" in order to uniquely identify all distinct trading schedules.

Several code systems exist to identify different financial markets, including: ISO 10383 Market Identification Codes (MICs), Reuters Instrument Code (RICs), and Bloomberg Exchange Codes. Unfortunately, none of these systems are granular enough to uniquely identify all distinct trading schedules that exist.

For example, the Chicago Mercantile Exchange (MIC: XCME) contains 9 different Segment MICs. However, the CME has far more than 9 distinct trading schedules. The CME has dozens of trading schedules that vary by product (ie. different hours and holidays for Cattle Futures vs Grain Futures). We fully support all of these schedules. So, a unique identifier was needed.

We maintain a mapping between MICs and FinIDs. However, there is some ambiguity.

Our team is available to help licensees determine which FinIDs are relevant to them by mapping between any market identifier you use and our FinIDs.

Data is available in multiple formats.

You can access the data through our modern JSON API. This allows you to immediately extract meaning information from the data, such as determining upcoming trading schedules for any supported market.

We also provide a bulk download option which allows you to import all information into your system at once. This is best for heavy usage.

All data is provided through our API. View the complete TradingHours.com API Documentation for more information.

Pricing depends on which data product you choose and what markets you need covered. This ensures that you only pay for what you need. There is no setup fee.

We charge by site license. For example, if your company has offices in New York and London then you would need 2 site licenses.

A site license is defined as a single office location where employees regularly work. For remote-first organizations, licenses are based on the size of the company.

Discounts are available for multiple site licenses.

Our global research team collects, collates, and verifies data using only primary sources. We monitor market announcements closely so we never miss an update.

Data accuracy is our highest priority. That is why TradingHours.com is trusted by world-leading financial institutions and fintech companies.

Our data updates frequently. Sometimes there are multiple updates per day.

As soon as we detect a change, our team updates our internal core database. Once the data is updated internally, it goes through multiple automated and manual checks to ensure accuracy. Finally, the data is deployed to our production system where it is immediately available to our clients through the API.

Trading holidays and holidays do change periodically. Sometimes these changes come with very short notice. Schedules can change due to political reasons, economic events, weather, or other issues.

For example, the beginning of Islamic and Hindu holidays depend on the visibility of the moon. As a result, in some countries, local weather can impact the official market closure dates. Sometimes these changes are announced less than 24 hours beforehand. We monitor these situations closely to ensure correctness.

Even in more established markets, holidays can change with short notice. For example, when former President George H.W. Bush died, the NYSE closed for a day of mourning with just 5 days notice.

We cover over 900 unique markets and trading venues across 100+ countries. We cover all major equity markets, options and futures markets, FX markets, and fix-income markets.

Click here to view our full market coverage.

If you need a market we don't cover, we will add it for free.

We have 3 tiers of markets: "Core", "Extended", and "All". Core markets include only major equity markets. Extended covers all global equity markets. The final tier, "All Markets", includes global options and futures markets as well.

These tiers exist so that you only pay for the data need.

Click here to view our full market coverage.

Yes, contact our sales team and request a data sample. Please specify what markets you are interested in.

Data obtained through our service may not be made publicly available or redistributed unless incorporated by you into a value-added product or service that does not allow extraction of a substantial portion of the data.

The only exception to this is the Market Status API. This API only provides real-time information about whether a market is open or closed. This information may be incorporated into your publicly facing website or application.

All licenses require a 1 year commitment. We offer NET30 payment terms. There is a 10% discount for yearly billing. Flexible terms are available for larger contracts.

The Market Status API can be billed month-to-month with a credit card on file.

Yes, our knowledgeable staff provides prompt customer support. We can answer technical questions about the API, clarify details about how and when markets trade, help with billing and payment issues, and assist with mapping FinIDs.

Please contact us with any questions.

Yes, we cover partial days and irregular trading schedules for all covered markets, including options and futures markets.

No, we do not cover halts or circuit breakers.

Our policy is that if a closure or halt is announced with less than 24 hours notice we only add it to our system if the entire market is closed and the closure lasts an entire day. In this case, the closure will be added after-the-fact.

If only some securities are closed or the closure lasts less than a full day, then it will not be covered in our data.

There is an exception for Islamic and Hindu holidays where sometimes the official holiday date is not set until less than 24 hours beforehand. We will always cover these holidays.