Harmonic Patterns Scanner FxMath_Harmonic_Hunter_Scanner(MT5)

The market scanner EA. It scans a grid of Pairs × Timeframes, detects harmonic patterns with an in-EA ZigZag engine and displays the results in an on-chart table, keeping only the highest-accuracy pattern per symbol+timeframe. On attach it writes the shared <AccountLogin>.Pouya settings file used by the Helper EA.

#Overview

The Scanner is a pure-MQL5 Expert Advisor. It needs no external indicators: the ZigZag pivot engine is implemented inside the EA (a faithful port of MetaQuotes' Examples\ZigZag, deviation = 5 × point, backstep = 3) and cached per symbol/timeframe/depth. The only external dependency is the standard <Trade\Trade.mqh> in the Helper and the WinInet DLL import used by httpGET() (Telegram / version check).

The scan loop runs on a real timer (EventSetTimer), so results stay fresh even when the market is closed or the chart is quiet. Every found signal can trigger Alert / Email / Push / Telegram notifications.

#User interface

The panel is drawn on the chart it is attached to (any chart — the Scanner scans its configured list, not the chart itself):

#Scanner Settings

#Trading Mode

These settings are forwarded to the Helper through the shared settings file and control the automatic position management:

#SL/TP Mode (shared with the Helper)

Two distinct ways of computing Stop Loss and Take Profit levels:

#Harmonic Patterns Settings

Pattern toggles

Each pattern family has an enable switch. Disabled families are skipped entirely:

#Notification Settings

Each signal message includes the full details (pair, TF, pattern, order type, open, SL, TP1–3) plus the signature line "Powered by FxMath Harmonic Hunter Scanner".

#Other Settings

#Detection engine

In-EA ZigZag

The EA contains a faithful port of MetaQuotes' Examples\ZigZag indicator with the same parameters the old iCustom calls used: depth (from the settings), deviation = 5 × point, backstep = 3. The buffer is series-indexed ([0] = current bar, 0.0 = not a pivot).

• Per-depth caching: depths 2…100 are cached per (symbol, timeframe, last-bar time) in a flat buffer, rebuilt only when the session changes (ZZ_Session → ZZ_BuildDepth → ZZ_Price).
• Scan window: scanBars = Maximum_Market_Bar_Scan + Maximun_Market_Depth. For each bar i and each depth in the configured range, the 5 most recent alternating pivots are collected (find()).
• Degenerate legs (zero-length XA/AB/BC/CD) are rejected.

Detection flow

Order direction

If D < C the pattern is Bullish → BUY; if D > C it is Bearish → SELL. The Scanner also filters by the current market price: bullish patterns require Ask > op23 (the entry is still below market), bearish patterns require Bid < op23 — stale patterns whose entry has already been passed are skipped.

#Built-in pattern table

14 entries (ratios verified against the reference sheet). Tolerances are applied as bound × (1 ± tol) where tol = (100 − Pattern_Accuracy) / 100.

Custom CSV patterns are disabled for now — the built-in 14-entry table is always used. The ReadCSV() call in OnInit is commented out; Custom_Patterns / Patterns_File_Name were removed from the Inputs tab (kept as plain variables so the code compiles).

#Accuracy scoring (the Acc column)

Every candidate is graded with AccuracyScore(xb, ac, bd, xd) — the average of four ratio-fit scores. A ratio inside its unscaled table range scores 1.0; outside, the score decays linearly from the range centre:

FitRatio(r, lo, hi):
  if lo ≤ 0      → 1.0
  if lo ≤ r ≤ hi → 1.0
  d = 1 − |r − mid| / mid   (clamped ≥ 0)
  → d

Because the score uses the unscaled bounds (snapshotted into acc_* globals before tolerance scaling), the Acc column varies: 100 for an exact table match, lower as ratios drift toward the tolerance edges. Among multiple candidates, the highest score wins; ties are broken by the newest D point (p_d < g_bestPd).

#The .Pouya settings file

On every attach the Scanner writes <AccountLogin>.Pouya into MQL5\Files\ — the bridge between Scanner and Helper. Contents:

# File: 3017.Pouya  (example, key=value lines, comma-separated CSV mode)
License=<account-check-response>
accuracy=80.0
Maximum_Market_Bar_Scan=20
Minimum_Market_Depth=25
Maximun_Market_Depth=50
Maximum_Pattern_Age=15
TakeProfit_Level=2
TradeComment=FxMath_Harmonic_Hunter
MagicNumber=3017
ExpirationTime_Candle=15
Close_Partial_Trade=1
Close_Partial_Ratio=0.60
Breakeven_Enable=1
BE_Ratio_Distance=0.60
SLTP_Use_ATR=0
SLTP_ATR_Period=14
SLTP_ATR_SL_Mult=2.00
SLTP_TP1_Mult=4.00
SLTP_TP2_Mult=6.00
SLTP_TP3_Mult=9.00
Helper_Text_Color=16777215
Pattern_Body_Color=65535
Custom_Patterns=false
Patterns_File_Name=Harmonic_Pattern.csv

The Helper parses these keys in read() on attach, so both EAs stay in sync.

#Auto symbol prefix/suffix detection

The Scanner auto-detects the broker's symbol prefix/suffix from the chart symbol (AutoDetectSymbolPrefixSuffix()) — there are no manual Prefix/Suffix inputs anymore:

• Suffix: strip a known base pair (19 FX/crypto/metals bases, e.g. XAUUSD, BTCUSD) at the start of the chart symbol, or walk currency codes at positions 0 and 3–6. EURUSD → no suffix; EURUSD.m → suffix .m.
• Prefix: whatever precedes a Pairs-list entry inside the base-only symbol. fxEURUSD → prefix fx.

#Recommended workflow

#Tuning tips

• Too many signals? Raise Pattern_Accuracy toward 90–95, lower Maximum_Pattern_Age to ~5–10, or disable pattern families you don't trade.
• Too few? Lower accuracy to 60–70, raise Maximum_Market_Bar_Scan and widen the depth range (e.g. 20–80).
• Faster scans: trim the Pairs / TFs lists and lower ZigZag_Window_Bars.
• ATR mode makes SL/TP market-aware (volatility-based) instead of ratio-based — useful in news-heavy or high-volatility sessions.
• Age column = bars since the D point. Fresh patterns (age 0–3) are generally more actionable.

#Known limitations

• Wolfe Waves disabled — to re-enable, set Wolfe_Pattern_Enable = true and uncomment //if(valid==0 && Wolfe_Pattern_Enable)WolfeScan(sym,tf,dep,point); in find().
• Custom CSV patterns disabled — uncomment ReadCSV() in OnInit and restore the inputs to re-enable.
• WinInet httpGET requires Allow DLL imports in the terminal and in the EA properties (license check is currently bypassed, so this is non-critical).
• License check is present but bypassed (License = true).
• Settings are read once at Helper attach — change Scanner settings while the Helper is running requires re-attaching the Helper.
• OnTick in the classic Scanner still calls Start() (redraws the header on every tick). The Panel version fixes this by driving everything from the timer.