Market Structure Evaluator MTF
- Indicators
- Version: 2.31
- Activations: 5
Market Structure Evaluator MTF Market Structure Evaluator MTF is an institutional-grade price action indicator designed for Smart Money Concepts (SMC) and Market Structure traders. It automatically tracks Market Structure Breaks (BOS) and Change of Character (CHOCH) in real-time across multiple timeframes, giving you a complete macro-to-micro view of market trend alignment without cluttering your charts or having to analyse other timeframes.
Whether you trade manually or build automated trading robots (EAs), Market Structure Evaluator MTF provides clear visual status updates, precise data window buffers, and zero-lag calculations.
Critical Trader Questions Answered Instantly
Most traders fail because they fight the higher timeframe trend or mistake a simple pullback for a structural reversal. Market Structure Evaluator MTF answers four vital questions the second you open any chart:
- What is the true structural trend? Knows instantly whether market structure is making Higher Highs / Higher Lows (Uptrend) or Lower Highs / Lower Lows (Downtrend).
- Is this a trend continuation (BOS) or a structural reversal (CHOCH)? Automatically labels structure breaks so you never guess whether a key level held or failed.
- Are higher timeframes aligned with my execution timeframe? Simultaneously monitors three customizable timeframes (e.g., M15 execution, H1 intermediate, H4 macro) and generates an alignment score.
- Is it safe to enter right now? Dynamic background panel state changes immediately warn you if you are trading into higher timeframe counter-trend resistance.
Key Features
- Dynamic Intuitive Background Panel: The dashboard panel automatically shifts color based on total multi-timeframe confluence:
- 🟢 Deep Bullish Green: 3/3 Timeframes fully aligned UP (Maximum Bullish Confluence).
- 🔴 Deep Bearish Red: 3/3 Timeframes fully aligned DOWN (Maximum Bearish Confluence).
- 🔵 Dark Navy / Neutral: Mixed market state or range-bound conditions (Caution / Wait for alignment).
- MTF Toggle Button: Integrated [MTF ON] / [MTF OFF] button located in the top-right corner of the panel for quick power control.
- Non-Repainting Signals: Once a bar closes and a BOS/CHOCH signal is confirmed, it stays fixed forever. Signals never shift, repaint, or disappear on historical bars if when confirmed.
- On-Chart Visuals + Data Window Output: Displays clean break lines, text labels, and structural arrows on the chart while cleanly pushing values into MT5's Data Window for external reading.
- Smart Swing Depth Detection: Easily configurable swing depth engine adapts to any asset class (Forex, Indices, Commodities, Crypto).
- Sequential State Machine: Walks through price action in chronological order, tracking EVERY swing high/low in real-time. Never misses a structure break. Panel and chart stay perfectly synchronized.
- MTF Performance Toggle: Click the button in the panel header to disable TF2/TF3 calculations when using an EA or away from the screen. Saves ~70% CPU. Panel shrinks to a clean header.
Built for Algorithmic Traders (EA Ready)
Market Structure Evaluator MTF was engineered ground-up for algorithmic developers. You do not need complex math to read signals in your Expert Advisor—simply use MT5's native iCustom() function to access the clean indicator buffers.
Indicator Buffer Mapping
- Buffer 0 (BuyBuffer): Returns the close price on a confirmed Bullish Break (BOS / CHOCH). Returns 0.0 when no signal is present.
- Buffer 1 (SellBuffer): Returns the close price on a confirmed Bearish Break (BOS / CHOCH). Returns 0.0 when no signal is present.
How to Call in Your EA (MQL5 Snippet)
// Create indicator handle in OnInit() int handleMSS = iCustom(_Symbol, _Period, "Market Structure Evaluator MTF"); // Read signals in OnTick() double buySignal[], sellSignal[]; ArraySetAsSeries(buySignal, true); ArraySetAsSeries(sellSignal, true); CopyBuffer(handleMSS, 0, 1, 1, buySignal); // Read completed bar (Index 1) CopyBuffer(handleMSS, 1, 1, 1, sellSignal); // Read completed bar (Index 1) if(buySignal[0] > 0) { // Execute Buy Order (Bullish Structure Break Confirmed) } else if(sellSignal[0] > 0) { // Execute Sell Order (Bearish Structure Break Confirmed) }
How to Use & Trading Workflow
Step 1: Set Up Your Timeframe Hierarchy
In the indicator settings, select your three working timeframes:
- TF1 (Execution): Current Chart Period (e.g., M5 or M15)
- TF2 (Intermediate): Trend Direction (e.g., H1)
- TF3 (Macro): Market Context (e.g., H4)
Step 2: Monitor Dashboard Alignment
Look at the SCORECARD at the bottom of the on-screen panel:
- SCORE 3/3: High-probability environment. Look for trade setups only in the direction of the confluence.
- SCORE 1/3 or 2/3: Mixed confluence. Trade with reduced lot size or wait for higher timeframe alignment.
Step 3: Trigger Entries on Execution Breaks
Wait for price action to form a swing high/low on TF1:
- Long Entry: Enter when a Bullish BOS/CHOCH signal fires while TF2 & TF3 are aligned UP.
- Short Entry: Enter when a Bearish BOS/CHOCH signal fires while TF2 & TF3 are aligned DOWN.
Inputs & Parameters Reference
Parameter Default Description InpPanelCorner CORNER_LEFT_UPPER Screen corner anchor for the dashboard panel InpPanelX / InpPanelY 20 / 20 Pixel offset position for the panel InpTF1 PERIOD_CURRENT Execution Timeframe (TF1) InpTF2 PERIOD_H1 Intermediate Structure Timeframe (TF2) InpTF3 PERIOD_H4 Macro Structure Timeframe (TF3) InpSwingDepth 3 Left/Right bars required to confirm a swing high/low InpHistoryBars 300 Number of historical bars to scan for structure InpBullColor clrLimeGreen Color for Bullish breaks & text labels InpBearColor clrRed Color for Bearish breaks & text labels InpShowLines true Show horizontal structure break lines on chart InpShowLabels true Show BOS / CHOCH text annotations on chart
Support & Requirements
- Platform: MT5
- Account Type: Any (Hedging & Netting supported)
- Symbols: Forex, Crypto, Stocks, Indices, Metals
For support, feature requests, or EA setup questions, feel free to send a direct message via the MQL5 Community profile!
Market Structure Evaluator MTF
Market Structure Evaluator MTF is an institutional-grade price action indicator designed for Smart Money Concepts (SMC) and Market Structure traders. It automatically tracks Market Structure Breaks (BOS) and Change of Character (CHOCH) in real-time across multiple timeframes, giving you a complete macro-to-micro view of market trend alignment without cluttering your charts or having to analyse other timeframes.
Whether you trade manually or build automated trading robots (EAs), Market Structure Evaluator MTF provides clear visual status updates, precise data window buffers, and zero-lag calculations.
Critical Trader Questions Answered Instantly
Most traders fail because they fight the higher timeframe trend or mistake a simple pullback for a structural reversal. Market Structure Evaluator MTF answers four vital questions the second you open any chart:
- What is the true structural trend? Knows instantly whether market structure is making Higher Highs / Higher Lows (Uptrend) or Lower Highs / Lower Lows (Downtrend).
- Is this a trend continuation (BOS) or a structural reversal (CHOCH)? Automatically labels structure breaks so you never guess whether a key level held or failed.
- Are higher timeframes aligned with my execution timeframe? Simultaneously monitors three customizable timeframes (e.g., M15 execution, H1 intermediate, H4 macro) and generates an alignment score.
- Is it safe to enter right now? Dynamic background panel state changes immediately warn you if you are trading into higher timeframe counter-trend resistance.
Key Features
- Dynamic Intuitive Background Panel: The dashboard panel automatically shifts color based on total multi-timeframe confluence:
- 🟢 Deep Bullish Green: 3/3 Timeframes fully aligned UP (Maximum Bullish Confluence).
- 🔴 Deep Bearish Red: 3/3 Timeframes fully aligned DOWN (Maximum Bearish Confluence).
- 🔵 Dark Navy / Neutral: Mixed market state or range-bound conditions (Caution / Wait for alignment).
- MTF Toggle Button: Integrated [MTF ON] / [MTF OFF] button located in the top-right corner of the panel for quick power control.
- Non-Repainting Signals: Once a bar closes and a BOS/CHOCH signal is confirmed, it stays fixed forever. Signals never shift, repaint, or disappear on historical bars if when confirmed.
- On-Chart Visuals + Data Window Output: Displays clean break lines, text labels, and structural arrows on the chart while cleanly pushing values into MT5's Data Window for external reading.
- Smart Swing Depth Detection: Easily configurable swing depth engine adapts to any asset class (Forex, Indices, Commodities, Crypto).
- Sequential State Machine: Walks through price action in chronological order, tracking EVERY swing high/low in real-time. Never misses a structure break. Panel and chart stay perfectly synchronized.
- MTF Performance Toggle: Click the button in the panel header to disable TF2/TF3 calculations when using an EA or away from the screen. Saves ~70% CPU. Panel shrinks to a clean header.
Built for Algorithmic Traders (EA Ready)
Market Structure Evaluator MTF was engineered ground-up for algorithmic developers. You do not need complex math to read signals in your Expert Advisor—simply use MT5's native iCustom() function to access the clean indicator buffers.
Indicator Buffer Mapping
- Buffer 0 (BuyBuffer): Returns the close price on a confirmed Bullish Break (BOS / CHOCH). Returns 0.0 when no signal is present.
- Buffer 1 (SellBuffer): Returns the close price on a confirmed Bearish Break (BOS / CHOCH). Returns 0.0 when no signal is present.
How to Call in Your EA (MQL5 Snippet)
// Create indicator handle in OnInit()
int handleMSS = iCustom(_Symbol, _Period, "Market Structure Evaluator MTF"); // Read signals in OnTick() double buySignal[], sellSignal[]; ArraySetAsSeries(buySignal, true); ArraySetAsSeries(sellSignal, true); CopyBuffer(handleMSS, 0, 1, 1, buySignal); // Read completed bar (Index 1) CopyBuffer(handleMSS, 1, 1, 1, sellSignal); // Read completed bar (Index 1) if(buySignal[0] > 0) { // Execute Buy Order (Bullish Structure Break Confirmed) } else if(sellSignal[0] > 0) { // Execute Sell Order (Bearish Structure Break Confirmed) }
How to Use & Trading Workflow
Step 1: Set Up Your Timeframe Hierarchy
In the indicator settings, select your three working timeframes:
- TF1 (Execution): Current Chart Period (e.g., M5 or M15)
- TF2 (Intermediate): Trend Direction (e.g., H1)
- TF3 (Macro): Market Context (e.g., H4)
Step 2: Monitor Dashboard Alignment
Look at the SCORECARD at the bottom of the on-screen panel:
- SCORE 3/3: High-probability environment. Look for trade setups only in the direction of the confluence.
- SCORE 1/3 or 2/3: Mixed confluence. Trade with reduced lot size or wait for higher timeframe alignment.
Step 3: Trigger Entries on Execution Breaks
Wait for price action to form a swing high/low on TF1:
- Long Entry: Enter when a Bullish BOS/CHOCH signal fires while TF2 & TF3 are aligned UP.
- Short Entry: Enter when a Bearish BOS/CHOCH signal fires while TF2 & TF3 are aligned DOWN.
Inputs & Parameters Reference
| Parameter | Default | Description |
| InpPanelCorner | CORNER_LEFT_UPPER | Screen corner anchor for the dashboard panel |
| InpPanelX / InpPanelY | 20 / 20 | Pixel offset position for the panel |
| InpTF1 | PERIOD_CURRENT | Execution Timeframe (TF1) |
| InpTF2 | PERIOD_H1 | Intermediate Structure Timeframe (TF2) |
| InpTF3 | PERIOD_H4 | Macro Structure Timeframe (TF3) |
| InpSwingDepth | 3 | Left/Right bars required to confirm a swing high/low |
| InpHistoryBars | 300 | Number of historical bars to scan for structure |
| InpBullColor | clrLimeGreen | Color for Bullish breaks & text labels |
| InpBearColor | clrRed | Color for Bearish breaks & text labels |
| InpShowLines | true | Show horizontal structure break lines on chart |
| InpShowLabels | true | Show BOS / CHOCH text annotations on chart |
Support & Requirements
- Platform: MT5
- Account Type: Any (Hedging & Netting supported)
- Symbols: Forex, Crypto, Stocks, Indices, Metals
For support, feature requests, or EA setup questions, feel free to send a direct message via the MQL5 Community profile!
