Free trading calendar REST API with holiday, late open, and early close. Over 60 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 |
| 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 |
| 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 |
| Wiener Borse | XWBO | ๐ฆ๐น Austria | https://www.wienerborse.at/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 |
| Iceland Stock Exchange | XICE | ๐ฎ๐ธ Iceland | 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 |
| Tallinn Stock Exchange | XTAL | ๐ช๐ช Estonia | https://nasdaqbaltic.com |
| Riga Stock Exchange | XRIS | ๐ฑ๐ป Latvia | https://nasdaqbaltic.com |
| Vilnius Stock Exchange | XLIT | ๐ฑ๐น Lithuania | https://nasdaqbaltic.com |
| Poland Stock Exchange | XWAR | ๐ต๐ฑ Poland | https://www.gpw.pl |
| Prague Stock Exchange | XPRA | ๐จ๐ฟ Czech Republic | https://www.pse.cz/en |
| Bucharest Stock Exchange | XBSE | ๐ท๐ด Romania | https://www.bvb.ro |
| Zagreb Stock Exchange | XZAG | ๐ญ๐ท Croatia | https://www.zse.hr/en |
| Budapest Stock Exchange | XBUD | ๐ญ๐บ Hungary | https://bse.hu |
| Moscow Exchange | XMOS | ๐ท๐บ Russia | https://www.moex.com/en |
| Astana International Exchange | AIXK | ๐ฐ๐ฟ Kazakhstan | https://www.aix.kz |
| Athens Stock Exchange | ASEX | ๐ฌ๐ท Greece | https://www.athexgroup.gr |
| Cyprus Stock Exchange | XCYS | ๐จ๐พ Cyprus | https://www.cse.com.cy/en-GB/home |
| 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 |
| Bombay Stock Exchange | XBOM | ๐ฎ๐ณ India | https://www.bseindia.com |
| Austrialian Securities Exchange | XASX | ๐ฆ๐บ Australia | https://www.asx.com.au |
| New Zealand Exchange | XNZE | ๐ณ๐ฟ New Zealand | https://www.nzx.com |
| Bermuda Stock Exchange | XBDA | ๐ง๐ฒ Bermuda | https://www.bsx.com |
| Singapore Exchange | XSES | ๐ธ๐ฌ Singapore | https://www.sgx.com |
| Shanghai Stock Exchange | XSHG | ๐จ๐ณ China | https://english.sse.com.cn |
| Hong Kong Stock Exchange | XHKG | ๐ญ๐ฐ Hong Kong | https://www.hkex.com.hk/?sc_lang=en |
| Taiwan Stock Exchange Corp. | XTAI | ๐น๐ผ Taiwan | https://www.twse.com.tw/en |
| Tokyo Stock Exchange | XTKS | ๐ฏ๐ต Japan | https://www.jpx.co.jp/english |
| Korea Exchange | XKRX | ๐ฐ๐ท South Korea | https://global.krx.co.kr |
| Malaysia Stock Exchange | XKLS | ๐ฒ๐พ Malaysia | https://www.bursamalaysia.com |
| 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 |
| B3 S.A. - Brasil Bolsa Balcao | BVMF | ๐ง๐ท Brazil | https://www.b3.com.br/en_us |
| 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 |
| Buenos Aires Stock Exchange | XBUE | ๐ฆ๐ท Argentina | https://www.bcba.sba.com.ar |
| Johannesburg Stock Exchange | XJSE | ๐ฟ๐ฆ South Africa | https://www.jse.co.za/z |
| Pakistan Stock Exchange | XKAR | ๐ต๐ฐ Pakistan | https://www.psx.com.pk |
| Saudi Stock Exchange | XSAU | ๐ธ๐ฆ Saudi Arabia | https://www.saudiexchange.sa |
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.