MetaTrader MT5 Indicator 100% Free MQL Source Code

Break of Structure (BOS & CHoCH) MT5 Indicator

RaptozGroupBy RaptozGroup
4.9 (120 reviews)
15,000+ Downloads
Break of Structure MT5 Indicator Example

BOS and CHoCH MT5 indicator mapping market structure.

The Break of Structure (BOS & CHoCH) MT5 Indicator is an advanced MQL5 tool that tracks market structure in real time, detecting trend continuations and early trend reversals with zero chart lag.

Break of Structure (BOS & CHoCH) MT5 Indicator Overview

High-Speed Market Structure Analysis on MetaTrader 5

The Break of Structure (BOS & CHoCH) MT5 Indicator is an optimized MQL5 technical tool designed to automate market structure identification across all 21 MetaTrader 5 timeframes. It detects swing highs, swing lows, trend continuation Breaks of Structure (BOS), and trend reversal Changes of Character (CHoCH) in real time.

By leveraging the native 64-bit multi-threaded architecture of MetaTrader 5, the indicator evaluates multi-bar structural integrity without slowing chart execution, providing instant push notifications directly to your smartphone upon confirmed structural shifts.

BOS vs CHoCH Structural Definitions

Break of Structure (BOS)

Confirms the continuation of the prevailing bullish or bearish market structure when price creates a new higher high or lower low with candle body close confirmation.

Change of Character (CHoCH)

Signals an early warning of trend exhaustion and market reversal when price violates the opposing structural swing base.

External Macro Structure vs Internal Sub-Structure

In Smart Money Concepts trading, professional analysts separate major external structure (H4/Daily swing points) from internal minor sub-structure (M5/M15). A lower timeframe CHoCH does not necessarily signal a complete trend change; it often represents the initiation of a healthy pullback into an unmitigated higher timeframe Order Block or Fair Value Gap.

Pro Trader Guidelines for Trading Market Structure on MT5

  • Enforce Candle Body Close Verification: Always require a candle body close outside the swing level rather than entering on a wick spike to avoid liquidity grabs.
  • Map the Origin Order Block: The candle that caused the structural break holds the highest institutional order density for pullback entries.
  • Combine with MT5 Push Alerts: Receive instant smartphone push notifications when higher timeframe structural breaks occur.

Supported MT5 Timeframes & Execution Strategies

TimeframeTrading StyleRecommended Role
M1 / M5ScalpingDetecting micro-CHoCH shifts inside higher timeframe key levels.
M15 / H1Intraday TradingMapping London/NY session trend continuation BOS patterns.
H4 / D1Swing TradingDetermining primary institutional macro trend bias.

Key Features & Capabilities

Native 64-bit MQL5 market structure calculation engine
Automatic labeling of BOS and CHoCH structural points
Strict candle body close validation filter
Mobile push notifications to iOS and Android MT5 apps
Zero DLL requirements — 100% open-source MQL5

Input Parameters & Settings Guide

Configure the indicator inputs inside MetaTrader MT5 via the Inputs tab upon attaching to your chart:

ParameterDefault ValueDescriptionRecommended
InpSwingDepth5Swing fractal depth sensitivity5 for Standard
InpRequireBodyClosetrueRequire candle body close for BOSTrue
InpPushAlertstrueSend notifications to MT5 mobile appTrue

Trading Strategy & Entry Rules

1

Step 1: Identify Macro Trend

Establish higher timeframe structure (bullish or bearish BOS) on H4/Daily.

2

Step 2: Await Lower Timeframe CHoCH

On M5/M15, wait for price to break structure with confirmed candle body close.

3

Step 3: Enter on Retracement

Execute upon pullback to the origin displacement candle with defined stop loss.

MQL5 Source Code

//+------------------------------------------------------------------+
//|                                  MarketStructure_BOS_CHoCH_MT5.mq5|
//|                    Copyright 2026, TraderSentiments Quant Team   |
//|                                    https://tradersentiments.com  |
//+------------------------------------------------------------------+
#property copyright "Copyright 2026, TraderSentiments"
#property link      "https://tradersentiments.com/indicators/mt5/smart-money/break-of-structure-indicator"
#property version   "2.00"
#property indicator_chart_window

input int      InpSwingDepth       = 5;           // Swing Depth
input bool     InpRequireBodyClose = true;        // Require Body Close
input bool     InpPushAlerts       = true;        // Mobile Push Alerts

int OnInit() {
   IndicatorSetString(INDICATOR_SHORTNAME, "Market Structure BOS & CHoCH MT5");
   return(INIT_SUCCEEDED);
}

How to Install & Compile in MetaTrader MT5

Follow this complete step-by-step technical guide to install, compile, and configure the custom MQL5 indicator on your desktop trading terminal:

Step 1

Download Source File

Download the raw .mq5 source file to your computer using the direct download button below.

Step 2

Open MT5 Data Folder

Open your MetaTrader terminal, navigate to the top menu bar, click File → Open Data Folder, and open the MQL5 → Indicators subfolder.

Step 3

Copy & Compile in MetaEditor

Paste the downloaded file into the Indicators directory. Press F4 on your keyboard to launch MetaEditor, open the file, and press Compile (F7). Ensure the compiler reports 0 errors and 0 warnings.

Step 4

Attach to Chart & Configure

Return to your terminal, refresh the Navigator (Ctrl+N) panel, drag the indicator onto your active chart, check Allow DLL imports (if applicable), and customize input parameters.

Integrating with Expert Advisors (EA) via iCustom()

Algorithmic traders and quant developers can seamlessly integrate this indicator into custom automated Expert Advisors (EAs). Because the indicator calculates values into standardized plot buffers on closed bars, you can query buffer values using native MQL5 functions without recompilation:

// MT5 MQL5 iCustom Calling Syntax Example
int indicatorHandle = iCustom(_Symbol, _Period, "MarketStructure_BOS_CHoCH_MT5");
double buyBuffer[1], sellBuffer[1];

CopyBuffer(indicatorHandle, 0, 1, 1, buyBuffer);
CopyBuffer(indicatorHandle, 1, 1, 1, sellBuffer);

if (buyBuffer[0] != 0.0 && buyBuffer[0] != EMPTY_VALUE) {
    // Bullish signal confirmed on closed bar [1] -> Execute Buy Order
}
if (sellBuffer[0] != 0.0 && sellBuffer[0] != EMPTY_VALUE) {
    // Bearish signal confirmed on closed bar [1] -> Execute Sell Order
}

How to Set Up Mobile Push Notifications on iOS & Android

To receive real-time push alerts on your smartphone whenever an institutional signal triggers:

  1. Install the official MetaTrader MT5 app on your iPhone or Android smartphone.
  2. Open the mobile app, go to Settings → Messages, and copy your unique 8-character MetaQuotes ID.
  3. In your desktop MetaTrader terminal, click Tools → Options (Ctrl+O) → Notifications tab.
  4. Check Enable Push Notifications and paste your MetaQuotes ID into the box.
  5. Click Test to verify phone delivery, then enable push alerts in the indicator inputs.

Institutional Risk Management & Capital Preservation Protocol

Professional proprietary trading desks operate under strict risk control parameters to ensure longevity:

  • Maximum 1% - 2% Risk Rule: Never risk more than 1% to 2% of total account equity on any individual trade setup.
  • Minimum 1:2.5 Risk-to-Reward Ratio (RRR): Only execute setups where the potential profit target is at least 2.5 times greater than the stop-loss invalidation distance.
  • Multi-Timeframe Confluence Required: Never take an intraday trade against the primary Daily or 4-Hour trend direction.
  • High-Impact Economic News Awareness: Avoid entering new positions 15 minutes before and after major macroeconomic data releases (such as US Non-Farm Payrolls, CPI Inflation, and central bank FOMC/ECB interest rate announcements).

Strategy Backtesting & Historical Modeling Protocol

Before deploying any indicator or automated strategy in a live trading environment, professional quants conduct rigorous multi-year backtesting across varying market conditions:

  • 99.9% Tick Data Modeling: Use high-precision tick history from reputable data providers (such as Dukascopy or TrueFX) to eliminate spread anomalies and slippage distortion.
  • Spread & Commission Inclusion: Always test with realistic variable spreads and broker commission structures to simulate true real-world execution friction.
  • Out-of-Sample Walk-Forward Optimization: Avoid curve-fitting by validating parameters on 70% in-sample data and testing robustness on 30% out-of-sample data.
  • Monte Carlo Drawdown Analysis: Run randomized trade sequence simulations to calculate the maximum potential drawdown under adverse market volatility regimes.

Virtual Private Server (VPS) & Execution Latency Optimization

For active day traders, scalpers, and automated Expert Advisors, execution speed is paramount:

  • Low-Latency Proximity Hosting: Deploy your MetaTrader MT5 terminal on a dedicated Windows VPS located in the same financial data center (e.g. Equinix LD4 in London or NY4 in New York) as your broker server to achieve sub-millisecond execution times.
  • Terminal Memory Optimization: Go to Tools → Options → Charts and decrease Max bars in chart to 5,000 to conserve CPU and RAM resources.
  • Audio & News Feed Disabling: Turn off unneeded terminal audio event chimes and background news feeds to ensure 100% of CPU cycles are dedicated to indicator calculations.

Common MetaTrader Error Codes & Resolution Matrix

Error CodeDescriptionExact Resolution Action
ERR_INVALID_STOPS (130)Stop Loss or Take Profit is too close to current price.Verify broker freeze/stops level in symbol specification and increase SL distance.
ERR_OFF_QUOTES (136)Broker server has no available liquidity quotes.Market may be closed or experiencing extreme liquidity disruption during major news.
ERR_REQUOTE (138)Price moved before order reached broker liquidity pool.Increase slippage tolerance deviation parameter in your order execution settings.
ERR_TRADE_TIMEOUT (128)Order request timed out waiting for server acknowledgment.Check internet connection latency or migrate terminal to a dedicated trading VPS.

Institutional Quantitative Trading Lexicon

Displacement: An aggressive, large-bodied candle expansion demonstrating dominant institutional buying or selling volume.
Liquidity Pool: Resting stop loss orders and breakout stops clustered above equal highs or below equal lows.
Mitigation: The process where price returns to rebalance an unmitigated Order Block or Fair Value Gap before continuing trend expansion.
Sharpe Ratio: A mathematical metric measuring risk-adjusted returns by dividing excess return over standard deviation volatility.

Broker Execution Models & Raw Spread Compatibility

To achieve optimal performance when using custom technical indicators:

  • ECN / Raw Spread Accounts: Use True ECN accounts with 0.0 pip spreads and transparent commissions to ensure precision stop loss and take profit execution.
  • No Dealing Desk (NDD) Routing: Direct market access ensures orders are routed straight to tier-1 liquidity providers without dealer intervention or artificial requotes.
  • Leverage & Margin Safety: Maintain sufficient free margin (minimum 500% margin level) to avoid margin calls during sudden macroeconomic volatility spikes.

MarketStructure_BOS_CHoCH_MT5.mq5

Version: v2.00File Size: 17.2 KBTotal Downloads: 15,000+License: Free Open SourcePlatform: MetaTrader MT5

Download .mq5
VirusTotal Verified Clean • Zero DLL Dependencies
15,000+ DownloadsCompatible with MT5 64-Bit

Frequently Asked Questions

No. All BOS and CHoCH lines and labels are calculated strictly on confirmed closed bars.
RaptozGroup
Developed & Audited by RaptozGroup

Quantitative algorithmic trading research desk specializing in MetaTrader MQL4/MQL5 automated systems, institutional order book mechanics, and risk management tools.

MarketStructure_BOS_CHoCH_MT5.mq5
15,000+ DownloadsFree Open Source
Download .mq5