Sign inSign up

apptasticsoftware/trading-calendar

By apptasticsoftware

•Updated 3 months ago

Trading calendar REST API for over 50 unique exchange calendars for equity and futures markets

Image
1

10K+

apptasticsoftware/trading-calendar repository overview

⁠Trading Calendar

Build codecov License

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

⁠Running it locally

⁠Pull the Docker Image

Pull pre-built image from Docker Hub repository⁠:

docker pull apptasticsoftware/trading-calendar:latest
⁠Start the Docker Container

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 it

Test that the docker container is working:

 http://127.0.0.1:8000/api/v1/markets?mic=XNYS
⁠Swagger UI

UI with interactive exploration, call and test API directly from the browser:

http://127.0.0.1:8000/docs
⁠ReDoc UI

Alternative API documentation with ReDoc:

http://127.0.0.1:8000/redoc
⁠OpenAPI

OpenAPI 3.1 specification:

http://127.0.0.1:8000/api/v1/openapi.json

⁠Calendars

ExchangeMICCountryRegion
Toronto Stock Exchange⁠XTSE🇨🇦 CanadaNorth America
New York Stock Exchange⁠XNYS🇺🇸 USANorth America
CBOE Futures⁠XCBF🇺🇸 USANorth America
Chicago Mercantile Exchange⁠CMES🇺🇸 USANorth America
ICE US⁠IEPA🇺🇸 USANorth America
Bermuda Stock Exchange⁠XBDA🇧🇲 BermudaNorth America
Mexican Stock Exchange⁠XMEX🇲🇽 MexicoNorth America
B3 S.A. - Brasil Bolsa Balcao⁠BVMF🇧🇷 BrazilSouth America
Santiago Stock Exchange⁠XSGO🇨🇱 ChileSouth America
Colombia Securities Exchange⁠XBOG🇨🇴 ColombiaSouth America
Lima Stock Exchange⁠XLIM🇵🇪 PeruSouth America
Buenos Aires Stock Exchange⁠XBUE🇦🇷 ArgentinaSouth America
London Stock Exchange⁠XLON🏴󠁧󠁢󠁥󠁮󠁧󠁿 EnglandEurope      
Euronext Amsterdam⁠XAMS🇳🇱 NetherlandsEurope      
Euronext Brussels⁠XBRU🇧🇪 BelgiumEurope      
Luxembourg Stock Exchange⁠XLUX🇱🇺 LuxembourgEurope      
Euronext Lisbon⁠XLIS🇵🇹 PortugalEurope      
Euronext Paris⁠XPAR🇫🇷 FranceEurope      
Frankfurt Stock Exchange⁠XFRA🇩🇪 GermanyEurope      
Deutsche Börse Xetra⁠XETR🇩🇪 GermanyEurope      
European Energy Exchange⁠XEEE🇩🇪 GermanyEurope      
Hamburg Stock Exchange⁠XHAM🇩🇪 GermanyEurope      
Duesseldorf Stock Exchange⁠XDUS🇩🇪 GermanyEurope      
SIX Swiss Exchange⁠XSWX🇨🇭 SwitzerlandEurope      
Bolsa de Madrid⁠XMAD🇪🇸 SpainEurope      
Borsa Italiana⁠XMIL🇮🇹 ItalyEurope      
Wiener Borse⁠XWBO🇦🇹 AustriaEurope      
Copenhagen Stock Exchange⁠XCSE🇩🇰 DenmarkEurope      
Helsinki Stock Exchange⁠XHEL🇫🇮 FinlandEurope      
Stockholm Stock Exchange⁠XSTO🇸🇪 SwedenEurope      
Iceland Stock Exchange⁠XICE🇮🇸 IcelandEurope      
Oslo Stock Exchange⁠XOSL🇳🇴 NorwayEurope      
Irish Stock Exchange⁠XDUB🇮🇪 IrelandEurope      
Tallinn Stock Exchange⁠XTAL🇪🇪 EstoniaEurope      
Riga Stock Exchange⁠XRIS🇱🇻 LatviaEurope      
Vilnius Stock Exchange⁠XLIT🇱🇹 LithuaniaEurope      
Poland Stock Exchange⁠XWAR🇵🇱 PolandEurope      
Prague Stock Exchange⁠XPRA🇨🇿 Czech RepublicEurope      
Bucharest Stock Exchange⁠XBSE🇷🇴 RomaniaEurope      
Zagreb Stock Exchange⁠XZAG🇭🇷 CroatiaEurope      
Budapest Stock Exchange⁠XBUD🇭🇺 HungaryEurope      
Moscow Exchange⁠XMOS🇷🇺 RussiaEurope      
Astana International Exchange⁠AIXK🇰🇿 KazakhstanEurope      
Athens Stock Exchange⁠ASEX🇬🇷 GreeceEurope      
Cyprus Stock Exchange⁠XCYS🇨🇾 CyprusEurope      
Istanbul Stock Exchange⁠XIST🇹🇷 TurkeyEurope
Austrialian Securities Exchange⁠XASX🇦🇺 AustraliaAsia-Pacific
New Zealand Exchange⁠XNZE🇳🇿 New ZealandAsia-Pacific
Singapore Exchange⁠XSES🇸🇬 SingaporeAsia-Pacific
Shanghai Stock Exchange⁠XSHG🇨🇳 ChinaAsia-Pacific
Hong Kong Stock Exchange⁠XHKG🇭🇰 Hong KongAsia-Pacific
Taiwan Stock Exchange Corp.⁠XTAI🇹🇼 TaiwanAsia-Pacific
Tokyo Stock Exchange⁠XTKS🇯🇵 JapanAsia-Pacific
Korea Exchange⁠XKRX🇰🇷 South KoreaAsia-Pacific
Malaysia Stock Exchange⁠XKLS🇲🇾 MalaysiaAsia-Pacific
Philippine Stock Exchange⁠XPHS🇵🇭 PhilippinesAsia-Pacific
Stock Exchange of Thailand⁠XBKK🇹🇭 ThailandAsia-Pacific
Indonesia Stock Exchange⁠XIDX🇮🇩 IndonesiaAsia-Pacific
Bombay Stock Exchange⁠XBOM🇮🇳 IndiaAsia-Pacific
Pakistan Stock Exchange⁠XKAR🇵🇰 PakistanAsia-Pacific
Tel Aviv Stock Exchange⁠XTAE🇮🇱 IsraelMiddle East
Saudi Stock Exchange⁠XSAU🇸🇦 Saudi ArabiaMiddle East
Johannesburg Stock Exchange⁠XJSE🇿🇦 South AfricaAfrica

Note that exchange calendars are defined by their ISO-10383⁠ market identifier code (MIC).

Tag summary

Content type

Image

Digest

sha256:53fb517b8…

Size

109.7 MB

Last updated

3 months ago

docker pull apptasticsoftware/trading-calendar