MT5 Multi‑Timeframe Candlestick Pattern Scanner & Backtester

A comprehensive tool to scan M5, M15, H1, H4, D1 charts for classical candlestick patterns, backtest their performance with realistic entry/exit simulation, and run a live scanner that alerts when a new pattern appears.

Features

• 20+ patterns: Doji, Hammer, Engulfing, Morning/Evening Star, Three White Soldiers, Marubozu, Harami, Tweezers, Rising/Falling Three Methods, etc.
• Stop Loss / Take Profit based on ATR (configurable multiplier, R:R ratio)
• Higher‑timeframe ATR for fast timeframes (M5/M15 automatically use H1 ATR → realistic SL/TP)
• Entry verification (stop orders only filled if touched on next candle)
• Forward evaluation with intra‑candle path simulation – avoids look‑ahead bias
• R‑level tracking (up to R5) and hit‑rate analysis
• Volume confirmation and D1 trend filter
• Deduplication – picks the highest‑priority pattern per candle
• Session classification (Asia, London, NY, etc.)
• Full backtests over date ranges → CSV reports, summary tables, and text reports
• Live scanner – monitors all active timeframes and prints formatted alerts when a new candle closes
• Position sizing (risk‑based) displayed in alerts

---

Installation

1. Install MetaTrader 5

2. Install Python dependencies: pip install MetaTrader5 pandas numpy colorama python-dotenv

3. Clone this repository (or copy mt5_multitf_pattern_scanner.py into a folder).

4. Create a .env file in the same directory as the script, containing your MT5 login credentials: .env

MT5_PATH=C:\Program Files\Broker\terminal64.exe

MT5_ACCOUNT=12345678

MT5_PASSWORD=YourPassword

MT5_SERVER=YourBrokerServer1

5. Run the script (see usage below).

Basic Usage Live Scanner (default) Monitors all active timeframes (M5, M15, H1, H4, D1) and prints alerts whenever a new candle closes and a pattern is detected.

python mt5_multitf_pattern_scanner.py To scan only specific timeframes:

python mt5_multitf_pattern_scanner.py --timeframes H1 H4 D1 Press Ctrl+C to stop.

One‑Shot Scan Scan the latest closed candle on all active timeframes and exit.

python mt5_multitf_pattern_scanner.py --mode scan Quick Backtest (last N bars) Simulate patterns on the most recent N candles (default 500) for a given timeframe. Useful for a fast performance snapshot.

python mt5_multitf_pattern_scanner.py --mode backtest --bars 500 --timeframes H4 Full Backtest (date‑ranged) Run a complete backtest over a specified date range. Generates CSV files (detections, pattern summary, session summary) and a detailed text report.

Backtest all timeframes for the full year 2025

python mt5_multitf_pattern_scanner.py --mode fullbacktest --from 2025-01-01 --to 2025-12-31

Backtest only H4 with D1 trend filter and volume filter enabled

python mt5_multitf_pattern_scanner.py --mode fullbacktest
--timeframes H4
--from 2025-01-01 --to 2025-12-31
--d1-trend-filter --volume-filter Output directory: ./backtest_results/ (can be changed with --output).

Configuration Most parameters can be changed via command‑line arguments:

Argument Description Default

--symbol Trading symbol EURUSD

--atr ATR period 14

--sl Stop loss multiplier (x ATR) 1.5

--tp Take profit multiplier (x ATR) 1.5

--forward Forward evaluation candles 15 for H4 (auto‑scaled per TF)

--volume-filter Enable volume confirmation False

--d1-trend-filter Require trend on D1 to match pattern direction False

--account-balance Account size for position sizing display 100000

--risk-percent Risk % of account per trade 1.0

See --help for the full list.