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
- 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).