Free trading 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 image from Docker Hub repository:
docker pull apptasticsoftware/trading-calendar:latest
Or pull image from GitHub Container Registry (GHCR):
docker pull ghcr.io/apptastic-software/trading-calendar:latest
Run a container based on the image from Docker Hub:
docker run -d --name trading-calendar -p 8000:80 apptasticsoftware/trading-calendar
Run a container based on the image from GHCR:
docker run -d --name trading-calendar -p 8000:80 ghcr.io/apptastic-software/trading-calendar
It will take around one minute for the container to start and accept requests.
Test that the 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:8000/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 |
| Luxembourg Stock Exchange | XLUX | ๐ฑ๐บ Luxembourg | https://www.luxse.com |
| 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 |
| European Energy Exchange | XEEE | ๐ฉ๐ช Germany | https://www.eex.com |
| Hamburg Stock Exchange | XHAM | ๐ฉ๐ช Germany | https://www.boerse-hamburg.de |
| Duesseldorf Stock Exchange | XDUS | ๐ฉ๐ช Germany | https://www.boerse-duesseldorf.de |
| 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 | https://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 | https://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).
MIT License
Copyright (c) 2024, Apptastic Software
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.