For the complete documentation index, see llms.txt. This page is also available as Markdown.

☕How "Multi-Candle" work ?

Normally a condition is checked on one candle only — the candle you pick in "Candle To Check".

Multi-Candle lets you ask for more: the condition must happen n times inside m candles. Use it when one single candle is too easy to trigger, and you want the market to confirm the same thing a few times.

The condition above triggers when RSI is over 70 on at least 2 of the last 3 candles.

Where to find it

Open Add / Edit condition. Right under Candle To Check there is a row:

  • Tick the checkbox to turn it on. The two selectors appear only after you tick it.

  • Left selector = n, how many candles must match.

  • Right selector = m, how many candles to look at.

  • The line under the row always shows the two ends of the window, so you can read exactly which candles are used.

  • Some conditions do not call a candle a "candle" — for those the row reads Multi-Bar: … Bars, and so on. It works the same way.

What it means

  • Candle To Check decides where the window starts.

  • The window is that candle plus the m - 1 candles before it. It always counts backwards, into the past.

  • The condition is met when at least n candles inside the window match. They do not need to be next to each other.

Candle To Check
Multi-Candle
Candles used
Met when

Current

2 times in 3 Candles

Current, 1 Previous, 2 Previous

2 or 3 of them match

Current

1 times in 5 Candles

Current … 4 Previous

any 1 of them matches

10 Previous

2 times in 3 Candles

10, 11, 12 Previous

2 or 3 of them match

Current

off

Current only

Current matches

Be careful with the direction when you do not start at "Current". With Candle To Check = 10 Previous and 2 times in 3 Candles, the window is 10, 11, 12 Previous — it goes further back in time. It is not 10, 9, 8 Previous. The "Window:" line under the row always spells this out:

Window: 10 Previous to 12 Previous — the window opens at the candle you picked and walks into the past.

Example

Condition: RSI(14) Over 70, Candle To Check = Current, Multi-Candle = 2 times in 3 Candles.

2 Previous
1 Previous
Current
Result

71.2

69.0

70.5

✅ alert — 2 candles above 70 (they are not side by side, that is fine)

65.0

71.5

72.0

✅ alert — 2 candles above 70

71.2

69.0

68.4

❌ no alert — only 1 candle above 70

Which candle is "Current" ?

This follows the Calculation Mode of the alert, exactly like a normal single-candle condition:

  • At End of Candle (called Closed Candle on a condition row) — "Current" is the last closed candle.

  • Every Minute (available only when Global Timeframe is MTF) — "Current" is the candle that is still forming, checked every minute.

Rules and limits

  • Multi-Candle is for indicator conditions. Patterns do not have it, because patterns have no candle option at all.

  • It appears only for conditions that have Candle To Check. A few conditions let you choose a candle for each side separately; those do not use this row.

  • m starts at 2. n can be 1 up to m.

  • The window can never go past the oldest candle we keep for that indicator: Candle To Check + m - 1 must stay inside the "Candle To Check" list. If you move Candle To Check further back, the choices for m get shorter — this is normal, not a bug.

  • Each condition in an alert has its own n and m. You can mix: one condition with Multi-Candle, another without.

  • Every candle in the window is checked with the same settings as the condition itself (Cross Over / Over / Under …, and the Distance limit if you use one).

  • Leave the checkbox off to keep the old behaviour — one candle, exactly as before. Alerts you created earlier are not changed.

Works together with "must meet" and "number conditions reach target"

Multi-Candle only decides whether this one condition is true or false right now. After that, your alert combines the conditions the usual way — see How "must meet" & "number conditions reach target" work ?

So 2 times in 3 Candles inside a condition, and 2 of 3 conditions for the alert, are two different things and can be used together.

Good to know

  • Not enough history (new symbol, or you just changed the timeframe): only the candles that really exist are counted. When the history is too short the alert stays quiet instead of triggering early.

  • A bigger window does not make the alert fire more often. How often an alert may trigger is decided by the alert's own settings, not by Multi-Candle.

  • Reading the "Window:" line is the fastest way to be sure: it names the first and the last candle of the window, so there is no doubt about which direction it counts.

  • The condition text itself carries the setting, so you can check it later without opening the condition again:

Last updated

Was this helpful?