90 lines
3.6 KiB
Markdown
90 lines
3.6 KiB
Markdown
# 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.
|