Break of Structure

Break of Structure is a free MT5 indicator that works on the main price chart, for traders who trade market structure and want swings and breaks marked the same way every time. When a closed bar breaks a confirmed swing high or low, it draws a line, a shaded zone and a "BOS" or "CHoCH" label, and it marks every swing with a small dot. In the Lab's repaint test, 0 of 714 checks changed after the fact. Once a break is drawn, it stays put.

What it draws on your chart

A break of structure (BOS) happens when price breaks a swing in the direction of the current trend. That is a sign the trend is continuing. A change of character (CHoCH) is a break against the trend, which is the first warning that the trend may be turning. The glossary covers both ideas in full. Here is what the tool puts on screen:

• BOS / CHoCH lines put a line at the broken swing level, with its BOS or CHoCH label.
• Break zones are rectangles that mark where structure broke.
• Swing points are small dots on each confirmed swing high and low.
• The Structure panel shows the last BOS or CHoCH and how many bars ago it happened, the current trend, BOS and CHoCH counts over recent bars, the trend on up to three higher timeframes, and which alert channels are on.

Everything draws in the main chart window. The indicator does not open a subwindow.

What the Lab tested and what 0 of 714 means

The Lab tested version 1.00 (96.1 KB) and finished on 2026-10-04. The Lab ran 714 repaint checks on v1.00 in MetaTrader 5 (build 6230) and none changed. The release notes do not describe the check procedure, symbol or timeframe, so read the result as a check on the code's logic, not on one market.

For you, this means a BOS you see in history is one you would also have seen live. Labels do not jump to a better bar later. The reason is the design: the tool only reads closed bars and only uses swings that are already confirmed.

Who it is for

The tool suits traders who already build trades around higher highs, higher lows and their breaks, and who want those breaks marked objectively, with alerts. It also helps if you are learning structure. Watching where the tool puts its dots and labels shows you which swings count under a fixed rule.

Install in one line

Copy the file into File → Open Data Folder → MQL5 → Indicators, refresh the Navigator, then drag Break of Structure onto a chart.

How to read the lines, zones and dots

The chart below shows the order things appear in. First come swing dots. Then a BOS forms as price breaks a swing high with the uptrend. After a higher low forms, a CHoCH forms as price breaks that low against the trend.

The swings in this picture are only a few bars apart so they fit. On a real chart with the default SwingLookback of 5, they sit further apart. On your chart, zones extend to the right until ZoneFadeBars removes them; the picture cuts them short to stay readable.

Two rules for reading it:

• A BOS says the trend shown on the panel just made a new swing in its own direction.
• A CHoCH says price broke the last swing that protected the trend. Treat it as a warning, not a reversal.

How one break forms

The common misread: "the dot showed up late"

A swing dot can only appear once SwingLookback bars have closed after the high or low. With the default of 5, the dot appears 5 bars after the actual turn. That delay is the price of a signal that does not repaint. It is not a bug.

The same delay applies to breaks. Because breaks are measured from confirmed swings, a high or low that has not yet been confirmed gives no level to break.

Reading the Structure panel

The panel shows the last break and how many bars ago it happened, so you can tell a fresh signal from an old one. It also shows the BOS and CHoCH counts over the last StatsLookbackBars closed bars (default 100). A run of BOS with almost no CHoCH points to a clean trend. The higher-timeframe rows tell you whether the larger charts agree with the break you are looking at.

The inputs to change first

• SwingLookback (2–15, default 5). This is the most important setting. Lower values find more, smaller swings and more labels, including more CHoCH flips in ranges. Higher values keep only the bigger swings, with fewer signals that arrive later.
• ShowBOSLabel / ShowCHoCHLabel. Switch one off if you only trade continuation or only want early warnings.
• ZoneFadeBars (default 150). This sets how many closed bars old lines, zones and dots stay on the chart. Lower it to keep a busy M1 chart clean. Set it to 0 to keep every object.
• MTF1–MTF3 (defaults M15, H1, H4). These choose the higher timeframes on the panel. Pick ones above the chart timeframe you trade.
• StatsLookbackBars (20–500). This sets how far back the panel counts BOS and CHoCH.
• PanelScale (default 1). Raise it if the panel is too small on your screen.

Alerts

The tool alerts you when a new BOS or CHoCH appears. Popups are on by default. Push notifications and sound are off. Set the starting state with EnableAlertPopup, EnableAlertPush and EnableAlertSound, or turn each channel on or off from the panel while the indicator runs. Because breaks are confirmed on closed bars, an alert always refers to a finished candle.

Decision rules for each signal

These are reading rules, not Lab results:

• BOS: act on it only when the panel's higher-timeframe trends point the same way. Skip a BOS that breaks against the higher timeframes. In our reading, on a lower chart that can be just noise inside a bigger pullback.
• CHoCH: do not reverse on the label alone. Wait for a BOS in the new direction before you treat the trend as changed. Until then, use the CHoCH to tighten or close a trade that ran with the old trend.
• Skip both when the panel's BOS and CHoCH counts are close over StatsLookbackBars. Labels in a range flip back and forth and lead nowhere.