Sequential Countdown for MetaTrader 5 and 4: the 9-13 setup and countdown count on closed bars, with alerts. Source, Python reference and tests.
  • MQL5 73.2%
  • MQL4 14.9%
  • Python 11.9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Allan Niñal Allan Niñal 2679c9c0c2 Free source regenerated: pop-up and push on by default
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-31 14:28:35 +08:00
docs Sequential Countdown: free MT5 and MT4 indicator source, Python reference, tests and README 2026-10-22 01:17:59 +08:00
LICENSES Sequential Countdown: free MT5 and MT4 indicator source, Python reference, tests and README 2026-10-22 01:17:59 +08:00
mql4 Free source regenerated: pop-up and push on by default 2026-10-31 14:28:35 +08:00
mql5 Free source regenerated: pop-up and push on by default 2026-10-31 14:28:35 +08:00
tests Sequential Countdown: free MT5 and MT4 indicator source, Python reference, tests and README 2026-10-22 01:17:59 +08:00
.gitignore Sequential Countdown: free MT5 and MT4 indicator source, Python reference, tests and README 2026-10-22 01:17:59 +08:00
LICENSE Sequential Countdown: free MT5 and MT4 indicator source, Python reference, tests and README 2026-10-22 01:17:59 +08:00
README.md Free source regenerated: Pro-only code removed from the engine, debug log added 2026-10-31 08:12:08 +08:00
requirements.txt Sequential Countdown: free MT5 and MT4 indicator source, Python reference, tests and README 2026-10-22 01:17:59 +08:00

Sequential Countdown logo

Sequential Countdown (MetaTrader 5 and MetaTrader 4)

A free indicator that numbers the 9-13 sequential count on the chart: setup 1 to 9 (perfected 9s marked) and countdown 1 to 13, on closed bars only, with alerts on every 9 and 13. The count has several published variants, so the exact one is stated in full. Source for both editions, a Python reference of the rules, and the tests that were used to check that the MT5 and MT4 code, the Python reference and each other all agree.

Website: allanninal.dev/mql5 (indicators) · MT4 editions · allanninal.dev · Contact: message me on LinkedIn.

A buy setup 9 and its countdown to 13 on GBPUSD H1

It is an indicator, not a strategy. It numbers bars and places no trades. A 9 or a 13 is a count, not a signal to buy or sell. Nothing here is a profit claim (see Honest limits).

Get it on the MQL5 Market

Edition Platform Price Link
Sequential Countdown MT5 free https://www.mql5.com/en/market/product/201875
Sequential Countdown MT4 MT4 free https://www.mql5.com/en/market/product/202363

The Market builds are the same calculation as the source in this repository.

Contents

  1. What it is and who it is for
  2. Why it was built
  3. How it works
  4. Non-repainting: the proof and how it was tested
  5. Architecture and buffers
  6. Inputs, alerts, install and compile
  7. Run the Python reference and the tests
  8. Honest limits
  9. Licence

What it is and who it is for

What: the 9-13 count in one stated variant. A setup counts 1 to 9 bars that each close beyond the close four bars earlier. A completed setup starts a countdown from 1 to 13. The indicator writes the setup numbers under (buy) or above (sell) the bars with the 9 in bold, marks a perfected 9, writes the countdown numbers further out in their own colours, and draws an arrow at a 13. Alerts: pop-up (on by default), sound, push notification, e-mail, on a completed 9 and a 13.

For: traders who already use the 9-13 count and want it counted by fixed, readable rules. Also for developers who want a small, tested counter with documented buffers to read from an EA with iCustom.

Not for: anyone who expects a 9 or a 13 to call a turn. The count marks where a run of closes completed.

sell sequence perfected or not
the rules inputs

Image notes: the charts are drawn by the Python reference on broker price history (the same numbers the indicator shows); the rules and settings sheets are illustrations, not terminal captures. MT4 versions are in docs/images/mt4/.

Why it was built

The 9-13 count is a long-standing method, but implementations disagree on the details (how a countdown is cancelled or restarted, how the 13 qualifies), so the same chart gets different numbers in different tools. The motivations, stated with the evidence we actually have:

  • One stated variant. docs/SPEC.md and the tables below say exactly which rules are used, and tests/reference.py is the rule book.
  • Trust in the numbers. A number is written when its bar closes and never changes afterwards. Our market research (October 2026) found repeated complaints about indicators that repaint.
  • Honest scale of demand. The same research found a small niche: about 16 indicators for this count on the MQL5 Market (one of them free), and only about 19 freelance-job mentions. This is a free tool with a clean, tested reference implementation, not a claim of mass demand.
  • Provable behaviour. Every number in this README comes from an executed check, listed below.
mindmap
  root((Sequential Countdown))
    Problem
      Variants disagree on the details
      Numbers that change after the bar closed
      Alerts that fire twice or during history load
    Design rules
      One stated variant
      Closed bars only
      One alert per bar
      Same rules on MT5 MT4 and Python
    Proof
      Python reference
      Bar by bar parity
      Tester repaint probe
      Market validation

How it works

The variant, step by step

k is the bar that just closed; C, H, L are close, high, low, with C[k-4] the close four bars earlier.

Buy setup

  1. A bar counts when C[k] < C[k-4].
  2. The count starts at 1 only after a flip: the previous bar closed above its own four-bars-earlier close (C[k-1] > C[k-5]). While the condition holds, the following bars count 2, 3 ...; any other bar resets the count to 0.
  3. At 9 the setup is complete and the count resets (a new setup needs a new flip).
  4. It is perfected if the low of bar 8 or bar 9 is at or below the lows of bars 6 and 7. A 9 that is not perfected is shown as 9'.
  5. The setup's resistance is the highest high of its nine bars.

Buy countdown

  1. A completed buy setup starts (or restarts, "recycle") a buy countdown, counting from setup bar 9 itself.
  2. A countdown bar is a bar with C[k] <= L[k-2]. The bars need not be consecutive.
  3. The 13th countdown bar must also have L[k] <= the close of countdown bar 8; a bar that meets the close rule but not this one is deferred (shown as +, not counted). 13 completes the countdown and ends it.
  4. The countdown is cancelled by a completed sell setup, or by a close above the resistance of the setup that started it.

Sell setup and countdown mirror all of it (C[k] > C[k-4], flip <, perfected on highs, countdown C[k] >= H[k-2], 13 needs H[k] >= the close of bar 8, cancelled by a buy setup or a close below the setup's support). A completed setup cancels the opposite countdown.

Per-bar algorithm

flowchart TB
    A[New or updated bar] --> B{Is it a closed bar?}
    B -- no, the forming bar --> Z[Nothing drawn, no alert]
    B -- yes --> C[Feed H L C to the engine]
    C --> D{At least 6 bars of history?}
    D -- no --> Z
    D -- yes --> E[Update both setup counts: close vs close 4 bars earlier, with the flip rule]
    E --> F{Setup count reached 9?}
    F -- yes --> G[Mark 9, perfected or 9', record the level, cancel the opposite countdown, start or restart this one]
    F -- no --> H[Keep counting]
    G --> I[Countdown step]
    H --> I
    I --> J{Closed beyond the setup level?}
    J -- yes --> K[Cancel the countdown]
    J -- no --> L{Close vs low or high 2 bars earlier qualifies?}
    L -- no --> Z2[No countdown number]
    L -- yes --> M{Already at 12?}
    M -- no --> N[Count 1 to 12, remember the close of bar 8]
    M -- yes --> O{Bar 13 condition met?}
    O -- yes --> P[13: arrow, countdown ends]
    O -- no --> Q[Deferred: shown as +]
    G --> R{Latest closed bar, after the history load?}
    P --> R
    R -- yes --> S[One alert for the bar]
    R -- no --> Z3[Drawn, no alert]

Count states (buy side; the sell side mirrors it)

stateDiagram-v2
    [*] --> Idle
    Idle --> Setup: flip, then a close below the close 4 bars earlier (count 1)
    Setup --> Setup: another bar below (2 to 8)
    Setup --> Idle: a bar that is not below resets the count
    Setup --> Countdown: count 9 reached (9 or 9', level recorded)
    Countdown --> Countdown: close at or below the low 2 bars earlier (1 to 12)
    Countdown --> Countdown: at 12, bar 13 fails its low test (deferred, +)
    Countdown --> Countdown: a new buy setup completes (restart from 0)
    Countdown --> Idle: 13 reached
    Countdown --> Idle: a sell setup completes
    Countdown --> Idle: a close above the setup resistance

Alert flow

sequenceDiagram
    participant T as Terminal
    participant I as Sequential indicator
    participant E as Engine (Seq.mqh)
    participant U as You
    T->>I: OnCalculate (history load, prev_calculated = 0)
    I->>E: feed the last InpHistory closed bars
    E-->>I: numbers per bar (drawn, no alert)
    T->>I: OnCalculate (new bar closes, prev_calculated > 0)
    I->>E: feed the one bar that just closed
    E-->>I: 9 and or 13 on that bar?
    alt a 9 or 13 and bar time is newer than the last alert and not in the tester
        I->>U: pop-up (optional sound, push, e-mail)
    else nothing completed, same bar again or tester run
        I-->>T: nothing sent
    end

How often it counts (measured)

Counts per 1,000 closed bars, default rules, on broker history of EURUSD, GBPJPY, XAUUSD and BTCUSD (H1: 374,992 bars, up to 100,000 per symbol; H4: 103,893; M15: 25,768 because the M15 history in the tester was shorter). It counts bars only, not what price does afterwards. Source: docs/data/count-frequency.json, made by tests/frequency.py.

xychart-beta
    title "Completed setups (9) and countdown 13s per 1,000 closed bars"
    x-axis ["M15", "H1", "H4"]
    y-axis "per 1,000 bars" 0 --> 30
    bar [25.26, 23.9, 26.36]
    bar [6.75, 6.15, 6.57]

First series: completed 9s (buy plus sell). Second series: completed 13s. About one 9 per 40 bars, and roughly one 9 in four goes on to a 13 (the rest are cancelled by an opposite setup or a close beyond the setup level, or are restarted). Of the 9s, about 73 to 78% are perfected at these defaults. The counts per bar are close on all three timeframes.

Non-repainting: the proof and how it was tested

"Non-repainting" is easy to claim. Here is what was actually run. Raw result files are in tests/results/.

1. Implementations compared bar by bar. The Python reference (tests/reference.py) holds the rules of the stated variant. The MT5 and MT4 indicators were dumped bar by bar (every buffer) in the MetaTrader Strategy Tester (MT4) or by a script (MT5), and tests/check_parity.py compared each dump with the reference: setup and countdown numbers must be identical on every closed bar.

Run on this exact code: compile 0 errors, 0 warnings (both editions); MT5 24 dumps and MT4 25 dumps (EURUSD, GBPJPY, XAUUSD, BTCUSD on M15, H1 and H4 with the repository's input sets; MT4 adds an every-tick run on EURUSD H1), all identical to the reference on every closed bar; the repaint probes found 0 closed bars that changed afterwards.

The wider matrix, made with the Market builds before this repository was cut from them (the same calculation; four symbols EURUSD, GBPJPY, XAUUSD, BTCUSD, M15, H1 and H4, the repository's input sets), checked here against the same reference:

MT5 MT4
dumps compared 24 25
bars compared 1,009,330 509,573
failures 0 0
result ALL PASS ALL PASS

Sources: tests/results/parity-wide-run-mt5.txt, tests/results/parity-wide-run-mt4.txt. MT5 history starts later than MT4's test history on some pairs, which is why the bar counts differ.

2. Repaint probe. An EA records which signal buffers are set on each bar at the moment it closes, then reads the same bars again at the end and counts any value that changed. It also counts any signal ever shown on the still-forming bar.

Run Closed bars checked Signals seen at close Changed afterwards Signals on the live bar
MT5, Market build, EURUSD H1, every tick, 10,411,052 ticks 4,644 5,145 0 0
MT4, Market build, 25 runs combined 506,172 3,218 0 0

Source: tests/results/repaint-summary.md. The MT5 probe was run once per build on one symbol and timeframe; the MT4 probe ran on every dump run.

3. Market validation. Both Market builds passed the MQL5 Market's automated product validation before publication (this is the Market's own check, not part of this repository).

flowchart LR
    R[reference.py<br/>Python rules] --> P
    S5[MT5 indicator] --> T5[Tester script<br/>DumpIndicator<br/>every bar to CSV]
    S4[MT4 indicator] --> T4[Tester EA<br/>Dump4.mqh<br/>CSV + repaint log]
    T5 --> P[check_parity.py<br/>identical on every closed bar]
    T4 --> P
    S5 --> RP[RepaintProbe EA<br/>values at close vs final]
    T4 --> RL[repaint log<br/>per run]
    P --> V{all pass?}
    RP --> V
    RL --> V
    V -- yes --> M[Market validation]
    V -- no --> F[fix, rerun everything]

Why the design cannot repaint

  • The engine is fed only bars up to rates_total - 2, i.e. never the forming bar, so a number is written only after its bar has closed.
  • Each decision uses that bar and earlier bars only (closes four bars earlier, lows or highs two bars earlier, the recorded setup bars). There is no look-ahead.
  • Alerts fire only for the bar that just closed, only after the history load, once per bar, and never in the tester.
  • What does depend on history length: the count is made from the first bar the indicator loads (InpHistory), so a count that was already running before that bar can start differently on a shorter history. Numbers on the loaded bars do not change as new bars arrive.

Architecture and buffers

flowchart TB
    subgraph MT5["mql5/Indicators/SequentialCountdown"]
        A5[SequentialCountdown.mq5<br/>inputs, buffers, numbers, OnCalculate]
        E5[Seq.mqh<br/>setup, perfected, countdown]
        B5[SignalAlerts.mqh<br/>alert inputs, SignalAlertMessage]
        A5 -- include --> E5
        A5 -- include --> B5
    end
    subgraph MT4["mql4/Indicators/SequentialCountdown"]
        A4[SequentialCountdown.mq4]
        E4[Seq.mqh<br/>identical to the MT5 file]
        B4[SignalAlerts.mqh<br/>MT4 edition]
        A4 -- include --> E4
        A4 -- include --> B4
    end
    subgraph TESTS[tests]
        R[reference.py]
        C[check_parity.py]
        D5[mql5: DumpIndicator, RepaintProbe, Params.mqh]
        D4[mql4: SequentialDump.mq4, Dump4.mqh]
        C --> R
    end
    D5 -. IndicatorCreate .-> A5
    D4 -. iCustom .-> A4
classDiagram
    class SequentialCountdown {
        +InpHistory int
        +InpAllSetup bool
        +InpCountdown bool
        +InpFontSize int
        +InpAlert9 bool
        +InpAlert13 bool
        +OnInit()
        +OnCalculate()
        +Num()
    }
    class SQState {
        +cnt int
        +bcnt scnt int
        +bcd scd int
        +b_on s_on bool
        +b_lvl s_lvl double
        +ev_setup perf ev_cd defer
        +h l c double[16]
    }
    class Engine {
        +SQInit()
        +SQFeed()
    }
    class SignalAlerts {
        +InpAlertPopup bool
        +InpAlertSound bool
        +InpAlertPush bool
        +InpAlertEmail bool
        +SignalAlertMessage()
    }
    class reference {
        +run()
    }
    SequentialCountdown --> Engine : feeds closed bars
    Engine --> SQState : ring of 16 bars
    SequentialCountdown --> SignalAlerts : alerts
    reference ..> Engine : same rules, compared by check_parity

iCustom buffer table (for EA developers)

Buffer MT5 MT4
0 Buy 13 arrow price (bar low on MT5, below it on MT4), empty otherwise same
1 Sell 13 arrow price (bar high on MT5, above it on MT4), empty otherwise same
2 buy setup count of the bar (1-8; 9 = complete; 10 = perfected 9) same
3 sell setup count of the bar (same coding) same
4 buy countdown number of the bar (1-13; -1 = deferred); empty otherwise same
5 sell countdown number of the bar (same coding) same

Empty value is EMPTY_VALUE. Read values on closed bars (shift 1 and higher). iCustom parameters follow the input order: history, show setup 1-8, show countdown, font size, buy, sell, buy countdown and sell countdown colours, (MT4 only: 13 arrow gap), alert on 9, alert on 13, pop-up, sound, sound file, push, e-mail, debug. In MT5 the input group headings also count as string parameters when you build a handle with IndicatorCreate (see tests/mql5/Include/IndTest/Params.mqh and the strings in tests/check_parity.py).

Inputs, alerts, install and compile

Input Default Meaning
Closed bars to count on the chart 1500 (100-20000) How far back the count starts
Show setup numbers 1-8 true Off: only the 9s are written
Show the countdown 1-13 true Countdown numbers in their own colours
Number font size 8 6-16
Buy, Sell, Buy countdown, Sell countdown colours green, red, blue, orange Look only
Alerts on a completed 9 / a 13 true / true Which events alert
13 arrow distance from the candle (MT4 only) 1.8 x ATR(14) MT4 cannot shift arrows by pixels
Pop-up alert true Terminal alert window
Play a sound / sound file false / alert.wav File from the terminal's Sounds folder
Push notification false Needs your MetaQuotes ID in Options
E-mail false Needs e-mail set up in Options
Debug log for bug reports false Writes extra lines to the Experts tab, to attach when you report a problem

Install from source. Copy mql5/Indicators/SequentialCountdown/ into <terminal data folder>/MQL5/Indicators/ (MT5) or mql4/Indicators/SequentialCountdown/ into <data folder>/MQL4/Indicators/ (MT4), open the .mq5 or .mq4 in MetaEditor and press Compile (F7). Both compile with 0 errors and 0 warnings (checked on a Windows machine with MetaEditor, from a clean scratch folder that holds only these files; the compiled files are not in the repository). Keep the three files of each edition together: the indicator includes Seq.mqh and SignalAlerts.mqh from its own folder. The debug log needs the Chart Kit file as well: copy mql5/Include/ChartKit/ (MT5) or mql4/Include/ChartKit/ (MT4) into the Include folder of the data folder.

Run the Python reference and the tests

python3 -m venv .venv && . .venv/bin/activate && pip install -r requirements.txt
import sys; sys.path.insert(0, "tests")
from reference import run
# high, low, close are float lists of closed bars, oldest first
rows = run(high, low, close)    # rows[k]: ev_setup (+1 buy 9, -1 sell 9), perf, ev_cd (13), bmark, smark, defer, ...

To repeat the parity check on your own data:

  1. Compile the indicator and the test tool for your platform (tests/mql5/Scripts/DumpIndicator, or tests/mql4/SequentialDump.mq4 with tests/mql4/Include/IndTest4/Dump4.mqh in your MQL4/Include/IndTest4/; MT5 also needs tests/mql5/Include/IndTest/Params.mqh).
  2. Run it in the Strategy Tester (MT4) or as a script (MT5) for each symbol and timeframe, with the input sets in tests/configs.tsv (MT5; the exact InpParams strings are in tests/check_parity.py) and tests/mql4/configs.tsv (MT4). The tool writes one CSV per symbol and timeframe into a dump folder.
  3. python3 tests/check_parity.py <folder that contains dump> (add --mt4 for MT4 dumps). It prints PASS or FAIL per file and an overall result.
  4. Repaint: run tests/mql5/Experts/RepaintProbe in the MT5 Strategy Tester (every tick); the MT4 test EA writes its repaint log with the dump.

The price dumps used for the published numbers are not in this repository (they are broker price data).

Honest limits

  • A count is not a strategy. No stop-loss, position sizing or exit rules are provided or implied, and the rules were not optimised or back-tested for profit. A 9 or a 13 says a run of closes completed, nothing about what comes next.
  • No profit or accuracy claim is made. The only numbers here are about consistency (the implementations agree, numbers do not move) and frequency (counts per 1,000 bars).
  • One variant of several. Other tools cancel, restart or qualify the count differently, so their numbers will differ from these on the same chart. The variant here is stated above and tested exactly.
  • The count depends on where it starts. A countdown that was already running before the first loaded bar is not seen, so the first numbers of a short history can differ from those of a longer one.
  • Frequent 9s. About one 9 per 40 bars; most are not followed by a 13.
  • Scope of the tests. Four symbols on M15, H1 and H4 for the Market builds (the same calculation), the repository's input sets, one MT5 repaint run; the code in this repository has so far been compile-checked only, and the MT5 build was not run on a live chart as part of these numbers. Other symbols and timeframes are not covered by the published numbers.

Licence

Copyright 2026 Allan Niñal (https://www.allanninal.dev/mql5). Licensed under the PolyForm Noncommercial License 1.0.0: source-available, free for personal and other noncommercial use, not for commercial use. Each source file has an SPDX-License-Identifier line. Text: LICENSE. The 9-13 count is a publicly described method; the code is original, written from the stated variant and not a port of any other program. The licence applies to this source, not to anything you build or trade with the indicator. Trading involves risk; the software is provided as is.


Website: allanninal.dev/mql5 · MT4 · allanninal.dev · Questions: message me on LinkedIn.