Home

Every trading day, every settlement date. MarketClock tells a trading desk or back office whether an exchange is open today, whether it closes early, and when a trade settles. It covers the 30 stock exchanges and financial markets in the Python holidays library, through a REST API, a web app and public calendar pages, and checks the library's dates against what each exchange publishes.

Status: feature-complete. It goes live at marketclock.ahmershah.dev in February 2027; until then run it locally or on your own server. See docs/status.md.

Start here

I want to	Read
Use the web app	Using MarketClock
Call the API	API Quick Reference
Know where the data comes from	Data Sources and Quality
Run it on my machine	Developer Setup
Run it on a server	Self Hosting
Fix a setup error	Troubleshooting
Understand how it is built	Architecture
Contribute a change	Contributing
Know how versions are numbered	Releases and Versioning
Quick answers	FAQ

The source of truth

This wiki is a short guide. The reviewed documentation lives in the repository and changes in the same pull request as the code:

• README: features, API, setup, stack
• docs/architecture.md: API rules, data sources and every decision
• docs/deploy.md: server setup, reverse proxy, releases
• SECURITY.md: how to report a vulnerability

If the wiki and the repository disagree, the repository is right; please open an issue.