Candle Timer and Spread (MT5) — User Guide

18 November 2026, 15:38
Claudio Hernan Ibarrola Diaz
0
6

Version 1.00 · MetaTrader 5 · free indicator

Candle Timer and Spread puts a small panel in a corner of the chart:

Time left in candle              M15
04:37
[=============--------]
Spread                        12 pts
Average (15 min)                13.4
Today  low / high             8 / 45
Server time                 21:10:23
  • Top: the timeframe, the time left until the current candle closes in large digits, and a progress bar.
  • Spread: the current spread, with a small coloured dot when you set a warning level.
  • Average: the spread averaged over the last minutes.
  • Today low / high: the lowest and the highest spread of the current day.
  • Server time: the clock the candles are timed with.
  • Tag next to the last candle: the countdown and the spread, beside the last candle.

The panel covers a small part of the chart in its corner: choose the corner and the distances in the inputs. It does not trade and gives no signals; the only alert is the optional pop-up before the candle closes (section 4). It changes nothing outside the chart it is attached to. The panel and its labels are in English in every language of the terminal.

About the input names in this guide. In the Inputs tab, MetaTrader shows each input by its description, for example Current spread. This guide writes the description in italics followed by the internal name in brackets, for example Current spread (ShowSpread).

1. Installing

  1. Download the indicator from the MQL5 Market from inside MetaTrader 5 (Navigator -> Market; free products are listed there too), or from the product page.
  2. In the Navigator, open Indicators (Market products are listed there, sometimes inside a Market folder) and drag Candle Timer and Spread onto a chart.
  3. Change the inputs you want in the Inputs tab and press OK.

To remove it: right-click the chart -> Indicators List -> select it -> Delete. The panel is removed with it.


2. Reading the display

The countdown. Under an hour it is mm:ss; from one hour, h:mm:ss; on the weekly and monthly charts it also shows the days, for example 2d 00:59:12. When the market is closed and no tick has arrived for more than a minute after the candle should have closed, it shows --:-- and the header says No recent ticks. The bar shows how much of the candle has gone by.

The spread. It is the spread the broker is quoting now, in points or pips (section 3). The average next to it is computed from one reading per second, over the last minutes you choose in Average over the last N minutes (AvgMinutes). The average starts when you attach the indicator: it does not read the past, so right after attaching it you will see -- or a short average. A spread of 0 (no quote recorded) is not counted. While the market has no ticks (no tick for three minutes) nothing is sampled.

The lowest and highest spread of the day. When you attach the indicator it starts from the one-minute bars of the day so far (each bar keeps one spread value, so very short widenings inside a minute may be missed at that point); from then on every tick counts. The day starts at the hour set in The day starts at this server hour (DayStartHour), by default midnight of the server clock, and the range starts again when a new day begins.


3. Points and pips

By default the spread is shown in points, the units the terminal itself uses. With Unit (SpreadUnit) set to Pips (10 points on 3 and 5 digit symbols), symbols with 3 or 5 digits show points divided by 10 (so 12 points are 1.2 pips); on any other symbol, such as gold with 2 digits, pips and points are the same number (the label then still says pts). The display uses a decimal point. Warn above this spread (WarnSpread) is in the unit you chose.


4. Warning and alert

With Warn above this spread (WarnSpread) above zero, the spread value and the tag next to the candle change to Warning colour of the spread (WarnColor) while the current spread is higher than that value, and a small dot next to the value shows green or the warning colour. This is a colour only.

With Alert N seconds before the candle closes (AlertSeconds) above zero, the terminal shows its Alert window once per candle when that many seconds are left (for example 30). It is off by default and is not sent by e-mail or to a phone.


5. The day change: why it can be left out

Not to be confused with the swap (also called rollover interest), the interest paid or charged for keeping a position open overnight. This indicator does not deal with the swap; here "day change" only means the moment the trading day changes and the spread widens.

Every trading day, at 17:00 New York time, the trading day changes. For a short time very little liquidity is quoted and brokers usually widen the spread a lot: on the pairs and the gold we looked at it was several times the normal spread, and on gold the market even pauses and reopens with a wide spread. On a server at New York + 7 hours this happens at 00:00 server time and lasts about one hour, until the spread goes back to normal.

This is not the same as the opening of the Asian, London or New York sessions. In the data we checked (EURUSD and gold, one-minute bars since June 2026, one broker) the spread widened at the day change and not at the session opens.

Those few minutes can dominate the numbers: the highest spread of the day would be the day-change spread every day, and the average would be pulled up while it lasts. For that reason Include day change in average and range (IncludeDayChange) is off by default. With it off:

  • from five minutes before the day change until Day change length in minutes (DayChangeMinutes, 60 by default) after it, nothing is added to the average or to the day's lowest and highest spread;
  • during that window the Average row shows the word day change instead of the number, and the warning colour is not used, so you can tell the wide spread is the usual one of that hour;
  • the current spread is always shown, as the broker quotes it.

Switch it on if you want to see everything, including the day-change spread, or if you are interested precisely in how wide it gets.

If your broker's day does not change at server midnight, set Day change server hour (DayChangeHour) to the hour where you see the spread widen every day. If the widening lasts longer or shorter, change DayChangeMinutes.


6. All the inputs

Show

Input (name in the Inputs tab) Default What it does
Time left until the candle closes (ShowTimer) true Shows the top of the panel: the timeframe, the large countdown to the close of the candle and its progress bar.
Current spread (ShowSpread) true Shows the Spread row with the current spread. The Average row belongs to it: it needs this input on.
Average spread (ShowAverage) true Adds the Average row: the average spread of the last minutes.
Lowest and highest spread of the day (ShowDayRange) true Adds the Today row: the lowest and the highest spread of the day so far.
Server time (ShowServerTime) true Adds the Server time row, the clock the candles are timed with.
Timer next to the last candle (ShowTag) true Writes the countdown and the spread in a small tag next to the last candle, at the price of the last tick.

Spread

Input (name in the Inputs tab) Default What it does
Unit (SpreadUnit) Points Points, or pips. A pip is 10 points on symbols with 3 or 5 digits; on any other symbol pips and points are the same.
Average over the last N minutes (1-240) (AvgMinutes) 15 Length of the window of the average, in minutes.
Warn above this spread (0 = off, same unit) (WarnSpread) 0 When the current spread is above this value, the spread line takes the warning colour. 0 turns the warning off. The value is in the unit chosen above.
The day starts at this server hour (0-23) (DayStartHour) 0 Server hour at which the day of the lowest and highest spread begins. 0 means midnight of the server clock.

Day change

Input (name in the Inputs tab) Default What it does
Include day change in average and range (IncludeDayChange) false Off (default): the spread of the day change is left out of the average and of the lowest and highest spread of the day. On: everything counts (section 5).
Day change server hour (0-23) (DayChangeHour) 0 Day change server hour. Most brokers close their day at 17:00 New York time, which is 00:00 on a server at New York + 7 hours.
Day change length in minutes (0-180) (DayChangeMinutes) 60 How long the spread is treated as day change after that hour. The five minutes before the day change are included as well.

Alert

Input (name in the Inputs tab) Default What it does
Alert N seconds before the candle closes (0 = off) (AlertSeconds) 0 Shows an Alert pop-up once per candle when this many seconds are left. 0 turns it off. Not used if the candle is not longer than that.

Look

Input (name in the Inputs tab) Default What it does
Corner of the chart (Corner) Right upper chart corner Corner of the chart where the panel is drawn.
Distance from the side (pixels) (OffsetX) 12 Distance from the side of the chart, in pixels.
Distance from the top or bottom (pixels) (OffsetY) 24 Distance from the top or the bottom of the chart, in pixels.
Font (FontFace) Consolas Font of the numbers in the panel and of the tag. Consolas (default) keeps every digit the same width; Segoe UI, Arial and Calibri are the other choices. The big timer digits use the bold weight of the chosen font. The labels always use Segoe UI.
Panel font size (6-24) (FontSize) 10 Size of the panel text; the whole panel grows or shrinks with it. The tag next to the candle has its own size.
Timer colour (none = automatic) (AccentColor) none Colour of the countdown and its progress bar (also of the tag, unless you set its own colour). With none, a teal that suits the background is used. The rest of the panel always follows the colours of the chart.
Candle tag: font size (6-24) (TagFontSize) 10 Size of the text next to the last candle (6-24). It is independent of the panel size.
Candle tag: colour (none = timer colour) (TagColor) none Colour of the text next to the last candle. With none it uses the timer colour. The warning colour still takes over when the spread is above your limit.
Warning colour of the spread (WarnColor) OrangeRed Colour of the spread value (and of the tag) when it is above the level of WarnSpread.

7. Examples

Purpose Inputs
Just the countdown Current spread, Average spread, Lowest and highest spread of the day and Server time off
A tidy spread monitor for a scalper Only Current spread and Average spread on; Warn above this spread (WarnSpread) at the level above which you do not trade
See the real day-change spread Include day change in average and range (IncludeDayChange) on
Bottom-left corner, bigger text Corner of the chart = Left lower chart corner, Font size 14
A warning 30 seconds before the close Alert N seconds before the candle closes (AlertSeconds) = 30

8. Troubleshooting

  • --:-- in the countdown. The market is closed or no tick has arrived for a while. It comes back with the next tick.
  • -- in Average or -- / -- in Today. There is no data yet: the average starts when you attach the indicator, and the day range stays empty while the day change window is excluded and no other minute of the day has been read. With the default settings the day range stays empty between 00:00 and 01:00 server time (the day change window) and fills in once it ends; with Include day change in average and range on, it fills in within a minute.
  • The spread looks too high or too low compared with another platform. The indicator shows what your terminal receives; compare it with the Spread column of the Market Watch window.
  • The panel covers something. Change Corner of the chart and the two distances, or lower the Font size.
  • The countdown is a few seconds off. It is computed from the server clock; a terminal that has just reconnected can be off until the next tick.

9. Frequently asked questions

Does it slow the terminal down? It updates a few chart objects once a second and on each tick. We have not measured its CPU use separately on a live chart, so we make no claim about it.

Does it work on any symbol? It works on any symbol that has a spread and price history in the terminal. We have tested forex pairs and gold.

Does it send or save anything? No. It uses no DLL, no web requests and writes no files.