Free market calendar REST API with holiday, late open, and early close. Over 50+ unique exchange calendars for global equity and futures markets.
Data includes:
- All holidays, including: trading holidays and partial days
- Support for timezones and daylight savings time transitions
- Definitions for weekends for each market
- Open and close time for each market
- Support for irregular and interday trading hours
- Current market status (open or closed based on static schedule).
Pull pre-built image from Docker Hub repository:
docker pull apptasticsoftware/trading-calendar:latest
Run a container based on the image:
docker run -d --name trading-calendar -p 8000:80 apptasticsoftware/trading-calendar
It will take around one minute for the container to start and accept requests.
Test that the docker container is working:
http://127.0.0.1:8000/api/v1/markets?mic=XNYS
UI with interactive exploration, call and test API directly from the browser:
http://127.0.0.1:8000/docs
Alternative API documentation with ReDoc:
http://127.0.0.1:8000/redoc
OpenAPI 3.1 specification:
http://127.0.0.1:8001/api/v1/openapi.json
| Exchange | MIC | Country | Exchange Website |
|---|---|---|---|
| New York Stock Exchange | XNYS | 🇺🇸 USA | https://www.nyse.com/index |
| CBOE Futures | XCBF | 🇺🇸 USA | https://markets.cboe.com/us/futures/overview/ |
| Chicago Mercantile Exchange | CMES | 🇺🇸 USA | https://www.cmegroup.com/ |
| ICE US | IEPA | 🇺🇸 USA | https://www.theice.com/index |
| Toronto Stock Exchange | XTSE | 🇨🇦 Canada | https://www.tsx.com/ |
| B3 S.A. - Brasil Bolsa Balcao | BVMF | 🇧🇷 Brazil | https://www.b3.com.br/en_us/ |
| London Stock Exchange | XLON | 🏴 England | https://www.londonstockexchange.com/home/homepage.htm |
| Euronext Amsterdam | XAMS | 🇳🇱 Netherlands | https://www.euronext.com/en/regulation/amsterdam |
| Euronext Brussels | XBRU | 🇧🇪 Belgium | https://www.euronext.com/en/regulation/brussels |
| Euronext Lisbon | XLIS | 🇵🇹 Portugal | https://www.euronext.com/en/regulation/lisbon |
| Euronext Paris | XPAR | 🇫🇷 France | https://www.euronext.com/en/regulation/paris |
| Frankfurt Stock Exchange | XFRA | 🇩🇪 Germany | https://en.boerse-frankfurt.de/ |
| Deutsche Börse Xetra | XETR | 🇩🇪 Germany | https://www.xetra.com/xetra-en/ |
| SIX Swiss Exchange | XSWX | 🇨🇭 Switzerland | https://www.six-group.com/exchanges/index.html |
| Tokyo Stock Exchange | XTKS | 🇯🇵 Japan | https://www.jpx.co.jp/english/ |
| Austrialian Securities Exchange | XASX | 🇦🇺 Australia | https://www.asx.com.au/ |
| Bolsa de Madrid | XMAD | 🇪🇸 Spain | http://www.bolsamadrid.es/ing/aspx/Portada/Portada.aspx |
| Borsa Italiana | XMIL | 🇮🇹 Italy | https://www.borsaitaliana.it/homepage/homepage.en.htm |
| New Zealand Exchange | XNZE | 🇳🇿 New Zealand | https://www.nzx.com/ |
| Wiener Borse | XWBO | 🇦🇹 Austria | https://www.wienerborse.at/en/ |
| Hong Kong Stock Exchange | XHKG | 🇭🇰 Hong Kong | https://www.hkex.com.hk/?sc_lang=en |
| Copenhagen Stock Exchange | XCSE | 🇩🇰 Denmark | https://www.nasdaqomxnordic.com/ |
| Helsinki Stock Exchange | XHEL | 🇫🇮 Finland | https://www.nasdaqomxnordic.com/ |
| Stockholm Stock Exchange | XSTO | 🇸🇪 Sweden | https://www.nasdaqomxnordic.com/ |
| Oslo Stock Exchange | XOSL | 🇳🇴 Norway | https://www.oslobors.no/ob_eng/ |
| Irish Stock Exchange | XDUB | 🇮🇪 Ireland | https://www.euronext.com/en/markets/dublin |
| Bombay Stock Exchange | XBOM | 🇮🇳 India | https://www.bseindia.com |
| Singapore Exchange | XSES | 🇸🇬 Singapore | https://www.sgx.com |
| Shanghai Stock Exchange | XSHG | 🇨🇳 China | http://english.sse.com.cn |
| Korea Exchange | XKRX | 🇰🇷 South Korea | https://global.krx.co.kr |
| Iceland Stock Exchange | XICE | 🇮🇸 Iceland | https://www.nasdaqomxnordic.com/ |
| Poland Stock Exchange | XWAR | 🇵🇱 Poland | https://www.gpw.pl |
| Santiago Stock Exchange | XSGO | 🇨🇱 Chile | https://inter.bolsadesantiago.com/sitios/en/Paginas/home.aspx |
| Colombia Securities Exchange | XBOG | 🇨🇴 Colombia | https://www.bvc.com.co/nueva/index_en.html |
| Mexican Stock Exchange | XMEX | 🇲🇽 Mexico | https://www.bmv.com.mx |
| Lima Stock Exchange | XLIM | 🇵🇪 Peru | https://www.bvl.com.pe |
| Prague Stock Exchange | XPRA | 🇨🇿 Czech Republic | https://www.pse.cz/en/ |
| Budapest Stock Exchange | XBUD | 🇭🇺 Hungary | https://bse.hu/ |
| Athens Stock Exchange | ASEX | 🇬🇷 Greece | https://www.athexgroup.gr |
| Istanbul Stock Exchange | XIST | 🇹🇷 Turkey | https://www.borsaistanbul.com/en/ |
| Tel Aviv Stock Exchange | XTAE | 🇮🇱 Israel | https://www.tase.co.il/Eng/Pages/Homepage.aspx |
| Johannesburg Stock Exchange | XJSE | 🇿🇦 South Africa | https://www.jse.co.za/z |
| Malaysia Stock Exchange | XKLS | 🇲🇾 Malaysia | https://www.bursamalaysia.com |
| Moscow Exchange | XMOS | 🇷🇺 Russia | https://www.moex.com/en/ |
| Philippine Stock Exchange | XPHS | 🇵🇭 Philippines | https://www.pse.com.ph/stockMarket/home.html |
| Stock Exchange of Thailand | XBKK | 🇹🇭 Thailand | https://www.set.or.th/set/mainpage.do?language=en&country=US |
| Indonesia Stock Exchange | XIDX | 🇮🇩 Indonesia | https://www.idx.co.id/ |
| Taiwan Stock Exchange Corp. | XTAI | 🇹🇼 Taiwan | https://www.twse.com.tw/en/ |
| Buenos Aires Stock Exchange | XBUE | 🇦🇷 Argentina | https://www.bcba.sba.com.ar/ |
| Pakistan Stock Exchange | XKAR | 🇵🇰 Pakistan | https://www.psx.com.pk/ |
| Saudi Stock Exchange | XSAU | 🇸🇦 Saudi Arabia | https://www.saudiexchange.sa/ |
| Astana International Exchange | AIXK | 🇰🇿 Kazakhstan | https://www.aix.kz/ |
| Bucharest Stock Exchange | XBSE | 🇷🇴 Romania | https://www.bvb.ro/ |
Note that exchange calendars are defined by their ISO-10383 market identifier code (MIC).