# 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](#features)
- [Supported Markets](#supported-markets)
- [Installation](#installation)
- [Supported Markets](#supported-markets)
- [Usage](#usage)
- [Contributing](#contributing)
- [License](#license)
## 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](https://www.jpx.co.jp/english/corporate/about-jpx/calendar/)||
| SSE (Shanghai Stock Exchange) | 2025 EOY | [SSE](https://english.sse.com.cn/start/trading/schedule/)||
| HKEX (Hong Kong Exchange) | 2025 EOY | [HKEX](https://www.hkex.com.hk/Services/Trading-hours-and-Severe-Weather-Arrangements/Trading-Hours/Securities-Market) ||
| BSE (Bombay Stock Exchange) | 2025 EOY | [BSE](https://www.bseindia.com/static/markets/marketinfo/listholi.aspx)| Note that [Muhurat trading](https://en.wikipedia.org/wiki/Muhurat_trading) is currently not supported.|
| LSE (London Stock Exchange) | 2026 EOY | [LSE](https://www.londonstockexchange.com/equities-trading/business-days)||
| NYSE (New York Stock Exchange)| 2027 EOY | [NYSE](https://www.nyse.com/markets/hours-calendars)||
| Nasdaq| 2025 EOY | [Nasdaq](https://www.nasdaq.com/market-activity/stock-market-holiday-schedule)||
## Installation
`uv` is needed. Install it if you haven't:
```bash
pip install uv
```
To use Market Clock, install it as a uv tool:
```bash
uv tool install market-clock
market-clock
```
or you can invoke it without installing:
```bash
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:
```bash
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.
```bash
uvx market-clock --show-seconds
```
`-lm`, `--list-markets`: List all supported markets without starting the clock.
```bash
uvx market-clock --list-markets
```
`-p`, `--print`: Print the clock and exit immediately.
```bash
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](LICENSE) file for details.
---
Raw data
{
"_id": null,
"home_page": null,
"name": "market-clock",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "cli, clock, exchange, stock market, trading",
"author": null,
"author_email": "plwg <56353330+plwg@users.noreply.github.com>",
"download_url": "https://files.pythonhosted.org/packages/67/0b/0b999b81bfcf44620b93240f4441e4b0842773a3973ef394dcc6acb45729/market_clock-0.2.0.tar.gz",
"platform": null,
"description": "# Market Clock\n\nMarket 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. \n\n\n\n## Table of Contents\n- [Features](#features)\n- [Supported Markets](#supported-markets)\n- [Installation](#installation)\n- [Supported Markets](#supported-markets)\n- [Usage](#usage)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Features\n\n- Displays trading status for major global stock exchanges.\n- Accounts for holidays and half trading days.\n- Considers lunch breaks for exchanges with lunch hours.\n- Real-time updates on when each market will open or close.\n\n## Supported Markets\n\nMarket Clock currently supports the following exchanges:\n\n| Exchange | Updated till| Source | Note|\n|-------------------------------|-------------|--------|-----|\n| TSE (Tokyo Stock Exchange) | 2026 EOY | [TSE](https://www.jpx.co.jp/english/corporate/about-jpx/calendar/)||\n| SSE (Shanghai Stock Exchange) | 2025 EOY | [SSE](https://english.sse.com.cn/start/trading/schedule/)||\n| HKEX (Hong Kong Exchange) | 2025 EOY | [HKEX](https://www.hkex.com.hk/Services/Trading-hours-and-Severe-Weather-Arrangements/Trading-Hours/Securities-Market) ||\n| BSE (Bombay Stock Exchange) | 2025 EOY | [BSE](https://www.bseindia.com/static/markets/marketinfo/listholi.aspx)| Note that [Muhurat trading](https://en.wikipedia.org/wiki/Muhurat_trading) is currently not supported.|\n| LSE (London Stock Exchange) | 2026 EOY | [LSE](https://www.londonstockexchange.com/equities-trading/business-days)||\n| NYSE (New York Stock Exchange)| 2027 EOY | [NYSE](https://www.nyse.com/markets/hours-calendars)||\n| Nasdaq| 2025 EOY | [Nasdaq](https://www.nasdaq.com/market-activity/stock-market-holiday-schedule)||\n\n## Installation\n\n`uv` is needed. Install it if you haven't:\n\n```bash\npip install uv\n```\n\nTo use Market Clock, install it as a uv tool:\n\n```bash\nuv tool install market-clock\nmarket-clock\n```\n\nor you can invoke it without installing:\n\n```bash\nuvx market-clock\n```\n\nTo exit the application, simply press `Ctrl + C`.\n\n## Usage\n\nMarket Clock supports several command line arguments to customize its behavior:\n\n`-m`, `--markets`: Specify which market(s) to display. For example, to show only NYSE and Nasdaq:\n\n```bash\nuvx market-clock --markets NYSE Nasdaq\n```\n\n If no market is specified, it will display the status for all supported markets.\n\n`-s`, `--show-seconds`: Display seconds in the countdown timer. By default, seconds are hidden.\n\n```bash\nuvx market-clock --show-seconds\n```\n\n`-lm`, `--list-markets`: List all supported markets without starting the clock.\n\n```bash\nuvx market-clock --list-markets\n```\n\n`-p`, `--print`: Print the clock and exit immediately.\n\n```bash\nuvx market-clock --print\n```\n\n## Contributing\n\nContributions are welcome! Please fork the repository and create a new branch for your feature or bug fix.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n--- \n",
"bugtrack_url": null,
"license": null,
"summary": "Market clock in your terminal",
"version": "0.2.0",
"project_urls": {
"Repository": "https://github.com/plwg/market-clock"
},
"split_keywords": [
"cli",
" clock",
" exchange",
" stock market",
" trading"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a37ebee4a869f0c857335384eeb157ca2f0f2caacbb8b75c77057d1d297d7622",
"md5": "beb2f5d8c3b6e81b6c54a965d76fb1c8",
"sha256": "3d8d2e01f7c52c87a6d71e4919ab00bd5e5bc48ebe229cec032699b5475824cf"
},
"downloads": -1,
"filename": "market_clock-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "beb2f5d8c3b6e81b6c54a965d76fb1c8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 7754,
"upload_time": "2025-08-11T00:48:12",
"upload_time_iso_8601": "2025-08-11T00:48:12.574292Z",
"url": "https://files.pythonhosted.org/packages/a3/7e/bee4a869f0c857335384eeb157ca2f0f2caacbb8b75c77057d1d297d7622/market_clock-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "670b0b999b81bfcf44620b93240f4441e4b0842773a3973ef394dcc6acb45729",
"md5": "ca75303708982cba39a84f4173b9d84c",
"sha256": "f54500ce1b5afe2ea598d0418d997060853e6725f90fb095d10c7b0d740aaa7a"
},
"downloads": -1,
"filename": "market_clock-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "ca75303708982cba39a84f4173b9d84c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 50671,
"upload_time": "2025-08-11T00:48:14",
"upload_time_iso_8601": "2025-08-11T00:48:14.186697Z",
"url": "https://files.pythonhosted.org/packages/67/0b/0b999b81bfcf44620b93240f4441e4b0842773a3973ef394dcc6acb45729/market_clock-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-11 00:48:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "plwg",
"github_project": "market-clock",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "market-clock"
}
JSON
