Market clock in your terminal
Project description
Market Clock
Market Clock is a minimalistic command-line clock that tracks the current trading status of multiple stock exchanges worldwide. It uses the released trading holidays to determine whether the markets are open or closed and counts down to the next trading event.
Table of Contents
Features
- Displays trading status for major global stock exchanges.
- Accounts for holidays and half trading days.
- Considers lunch breaks for exchanges with lunch hours.
- Real-time updates on when each market will open or close.
Supported Markets
Market Clock currently supports the following exchanges:
| Exchange | Updated till | Source | Note |
|---|---|---|---|
| TSE (Tokyo Stock Exchange) | 2026 EOY | TSE | |
| SSE (Shanghai Stock Exchange) | 2025 EOY | SSE | |
| HKEX (Hong Kong Exchange) | 2025 EOY | HKEX | |
| BSE (Bombay Stock Exchange) | 2025 EOY | BSE | Note that Muhurat trading is currently not supported. |
| LSE (London Stock Exchange) | 2026 EOY | LSE | |
| NYSE (New York Stock Exchange) | 2027 EOY | NYSE | |
| Nasdaq | 2025 EOY | Nasdaq |
Installation
uv is needed. Install it if you haven't:
pip install uv
To use Market Clock, install it as a uv tool:
uv tool install market-clock
market-clock
or you can invoke it without installing:
uvx market-clock
To exit the application, simply press Ctrl + C.
Usage
Market Clock supports several command line arguments to customize its behavior:
-m, --markets: Specify which market(s) to display. For example, to show only NYSE and Nasdaq:
uvx market-clock --markets NYSE Nasdaq
If no market is specified, it will display the status for all supported markets.
-s, --show-seconds: Display seconds in the countdown timer. By default, seconds are hidden.
uvx market-clock --show-seconds
-lm, --list-markets: List all supported markets without starting the clock.
uvx market-clock --list-markets
-p, --print: Print the clock and exit immediately.
uvx market-clock --print
Contributing
Contributions are welcome! Please fork the repository and create a new branch for your feature or bug fix.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file market_clock-0.3.1.tar.gz.
File metadata
- Download URL: market_clock-0.3.1.tar.gz
- Upload date:
- Size: 51.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
730dc58b547b19881edce392493b7ffd9858476d260ed606376d7f34a685c8ac
|
|
| MD5 |
0e6df7d6266b46243d4453c8ab4ee54e
|
|
| BLAKE2b-256 |
b06ebc53af31d55c9eb483bae97cf8a7f985bfe1e511e7aa882c2737b1b2823d
|
File details
Details for the file market_clock-0.3.1-py3-none-any.whl.
File metadata
- Download URL: market_clock-0.3.1-py3-none-any.whl
- Upload date:
- Size: 8.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
40d5b630547e4d4f2387d4f6a801297c9f95c5a35953dcfd85850a04e84f5e0f
|
|
| MD5 |
94aaf49c3b972fadc281b2fdda34b636
|
|
| BLAKE2b-256 |
9ac31bbc69a04684347c891c1b989ba18c7b677e9905b4e1625548f35bdc2ce4
|
