OPEN-SOURCE SCRIPT
Candle Countdown Timer

A simple chart-based timer designed to help traders stay aware of upcoming candle closes.
Trading Timer provides a real-time countdown to the next candle close directly on your chart, helping you prepare for timeframe changes, review setups, and maintain a consistent trading routine.
Built for discretionary traders who rely on candle closes as important decision points, the indicator provides a clean visual countdown, optional alerts, and a compact dashboard that stays out of the way of your analysis.
---
Features
✓ Real-time candle close countdown
✓ Customisable timeframe selection
✓ Alerts before candle close
✓ Automatic symbol recognition
✓ Mobile notifications through TradingView alerts
✓ Compact dashboard display
✓ Minimal mode for a cleaner workspace
✓ Colour-coded timing zones:
Countdown Phases:
🔵Dark grey — waiting
🟡Yellow — approaching close
🔴Red — final minute
---
Alert Setup
To receive notifications, create a TradingView alert after adding Trading Timer to your chart.
Recommended setup:
The alert is linked to the chart where it was created. If you want alerts for multiple markets (for example Gold and NAS100), create a separate alert for each chart.
For mobile notifications, make sure TradingView app notifications are enabled on your device.
Example Setup:
For a 15-minute trading setup, set the indicator to 15 minutes and choose your preferred warning time (for example, 1 minute before close)."
The timer keeps you informed so you can focus on the chart instead of watching the clock!
---
Intended Use
Trading Timer is a timing and workflow tool. It does not provide trade signals, entries, exits, or predictions.
It is designed to help traders:
Suitable for markets including forex, futures, indices, commodities, stocks, and crypto.
---
How it looks on the charts:

Compact Dashboard Display:

Trading Timer provides a real-time countdown to the next candle close directly on your chart, helping you prepare for timeframe changes, review setups, and maintain a consistent trading routine.
Built for discretionary traders who rely on candle closes as important decision points, the indicator provides a clean visual countdown, optional alerts, and a compact dashboard that stays out of the way of your analysis.
---
Features
✓ Real-time candle close countdown
✓ Customisable timeframe selection
✓ Alerts before candle close
✓ Automatic symbol recognition
✓ Mobile notifications through TradingView alerts
✓ Compact dashboard display
✓ Minimal mode for a cleaner workspace
✓ Colour-coded timing zones:
Countdown Phases:
🔵Dark grey — waiting
🟡Yellow — approaching close
🔴Red — final minute
---
Alert Setup
To receive notifications, create a TradingView alert after adding Trading Timer to your chart.
Recommended setup:
- Add Trading Timer to your preferred chart timeframe (for example, 15 minutes).
- Open TradingView's Alert menu.
- Under Condition, select:
- Trading Timer → Any alert() function call
- Choose your preferred notification options
- Create the alert.
The alert is linked to the chart where it was created. If you want alerts for multiple markets (for example Gold and NAS100), create a separate alert for each chart.
For mobile notifications, make sure TradingView app notifications are enabled on your device.
Example Setup:
For a 15-minute trading setup, set the indicator to 15 minutes and choose your preferred warning time (for example, 1 minute before close)."
The timer keeps you informed so you can focus on the chart instead of watching the clock!
---
Intended Use
Trading Timer is a timing and workflow tool. It does not provide trade signals, entries, exits, or predictions.
It is designed to help traders:
- Prepare before candle closes
- Review setups at consistent intervals
- Manage multi-timeframe workflows
- Stay disciplined with candle-based analysis
Suitable for markets including forex, futures, indices, commodities, stocks, and crypto.
---
How it looks on the charts:
Compact Dashboard Display:
Mã nguồn mở
Theo đúng tinh thần TradingView, tác giả của tập lệnh này đã công bố nó dưới dạng mã nguồn mở, để các nhà giao dịch có thể xem xét và xác minh chức năng. Chúc mừng tác giả! Mặc dù bạn có thể sử dụng miễn phí, hãy nhớ rằng việc công bố lại mã phải tuân theo Nội quy.
Thông báo miễn trừ trách nhiệm
Thông tin và các ấn phẩm này không nhằm mục đích, và không cấu thành, lời khuyên hoặc khuyến nghị về tài chính, đầu tư, giao dịch hay các loại khác do TradingView cung cấp hoặc xác nhận. Đọc thêm tại Điều khoản Sử dụng.
Mã nguồn mở
Theo đúng tinh thần TradingView, tác giả của tập lệnh này đã công bố nó dưới dạng mã nguồn mở, để các nhà giao dịch có thể xem xét và xác minh chức năng. Chúc mừng tác giả! Mặc dù bạn có thể sử dụng miễn phí, hãy nhớ rằng việc công bố lại mã phải tuân theo Nội quy.
Thông báo miễn trừ trách nhiệm
Thông tin và các ấn phẩm này không nhằm mục đích, và không cấu thành, lời khuyên hoặc khuyến nghị về tài chính, đầu tư, giao dịch hay các loại khác do TradingView cung cấp hoặc xác nhận. Đọc thêm tại Điều khoản Sử dụng.