Breakout Detector
breakout detector is a market structure and breakout confirmation tool built to track dynamic price rails, identify compression, evaluate participation, map swing structure, and confirm breakouts only when price action meets a defined set of conditions.
the indicator is designed around a simple principle: crossing a level is not enough to qualify as a confirmed breakout. the breakout engine requires a confirmed close beyond the previous rail together with sufficient candle displacement and relative volume participation.
rail engine
the upper and lower rails form the core structure of the indicator.
rail length
sets the donchian calculation period used to build the base upper and lower boundaries. shorter values make the rails react faster to recent price action, while longer values create slower structural levels.
rail smoothing
applies ema smoothing to the calculated rails. increasing this value produces smoother and less reactive boundaries.
atr envelope padding
adds an atr-based envelope around the donchian structure. this helps prevent minor price movements around the raw highs and lows from being treated as meaningful structural breaks.
adaptive padding
when enabled, the rail padding automatically adjusts using recent volatility in addition to the base atr padding.
draw rails
shows or hides the upper and lower rail system on the chart.
breakout confirmation
the breakout engine works from the previous confirmed rail values rather than allowing the current breakout candle to move its own threshold.
a confirmed breakout requires three main conditions:
close — price must close beyond the previous rail. wick-only penetration is rejected.
body displacement — the breakout candle must have enough body size relative to the previous atr.
relative volume — current volume must meet the configured participation threshold compared with the previous 50-bar average.
detect confirmed breakouts
enables or disables the breakout engine.
min body displacement
controls the minimum candle body size required for confirmation, expressed as a multiple of atr.
higher values demand stronger displacement. lower values make the detector more sensitive.
min relative volume
defines the minimum participation required for a breakout.
for example, a value of 1.15 requires current volume to reach approximately 1.15 times the reference volume.
breakout history
controls how many confirmed breakout events are retained by the indicator, up to 50.
show breakout markers
displays historical confirmed breakout markers directly at the rail price that triggered each event.
the engine records only one event for each breakout episode. another breakout in the same direction cannot be generated continuously while price remains outside the rail. the engine is re-armed after a confirmed close returns inside the previous rail channel.
compression
the compression engine compares bollinger bands with a keltner channel and also calculates a normalized compression score from recent bollinger bandwidth.
bb / kc length
sets the calculation period used by both systems.
bollinger mult
controls bollinger band width.
keltner mult
controls keltner channel width.
compression field
enables the visual field between the rails when compression conditions become significant.
the institutional panel can display three compression states:
armed — bollinger bands are inside the keltner channel.
charging — compression is elevated according to the bandwidth compression score.
open — no strong compression condition is currently detected.
compression does not represent a breakout by itself. it provides information about volatility contraction that may precede expansion.
market structure
the indicator can automatically identify confirmed swing structure.
hh — higher high
lh — lower high
hl — higher low
ll — lower low
hh / lh / hl / ll
enables or disables structure labels.
swing pivot length
controls how much confirmation is required around a pivot. larger values produce fewer, more significant structural points, while smaller values react to shorter-term swings.
these labels can help determine whether a breakout agrees with the surrounding market structure or is occurring against it.
volume delta
delta gradient on bars
colors candles according to an approximation of directional lower-timeframe volume.
the indicator automatically selects a lower timeframe according to the current chart timeframe and aggregates positive or negative volume based on lower-timeframe candle direction.
positive delta indicates greater estimated bullish directional volume, while negative delta indicates greater estimated bearish directional volume.
this is an approximation derived from lower-timeframe price and volume data. it is not exchange bid/ask footprint delta.
chart visuals
three chart themes are available:
institutional
graphite cyan
graphite gold
rail halo
adds a wider transparent layer around the rails for increased visual separation.
current distance to rails
shows the current distance from price to the upper and lower rails in atr units.
rail grid
adds internal horizontal reference levels between the upper and lower rails.
extend right
controls how far visual rail elements extend beyond the current bar.
institutional panel
the panel provides a compact real-time view of the breakout environment.
engine
shows whether the breakout detector is armed or whether an upper or lower breakout episode is currently active.
regime
classifies the current environment as drift, compression, expansion, breakout up, or breakout down.
upper rail / lower rail
shows each current rail price together with its distance from market price in atr units.
compression
shows the current compression state and normalized compression score.
flow
uses the normalized slope of the rail midpoint to classify directional movement as ascent, descent, or neutral.
participation
shows current relative volume.
ltf delta
shows the approximate lower-timeframe directional volume delta.
last break
displays the direction, age, and rail price of the most recent confirmed breakout.
history
shows how many breakout events are currently stored.
confirmation
reminds the user that breakout confirmation is based on close, body displacement, and relative volume.
the panel can be positioned in any chart corner and displayed in tiny, small, or normal text size.
quick start
start with the default settings and allow the rails to define the current structural price channel.
watch the regime and compression fields. when compression begins to increase, volatility is contracting and the market may be preparing for expansion, although compression alone does not determine direction.
use the upper and lower rails as the active breakout boundaries.
when price approaches a rail, check participation, lower-timeframe delta, flow, and surrounding hh/lh/hl/ll structure for additional context.
a wick through a rail will not produce a confirmed breakout.
for an upper breakout, the candle must close above the previous upper rail, close bullish, meet the minimum body displacement requirement, and satisfy the relative volume threshold.
the opposite conditions apply to a lower breakout.
after confirmation, the breakout is stored in history and marked at the rail level that triggered the event.
the engine remains locked for repeated signals in that direction until price closes back inside the rail channel. this prevents a sequence of candles outside the same boundary from being counted as multiple independent breakouts.
adjusting sensitivity
for stricter breakout confirmation, increase min body displacement and min relative volume. this requires stronger price expansion and participation before an event is accepted.
for more responsive rails, reduce rail length or rail smoothing.
for slower structural rails, increase these values.
increasing atr envelope padding moves the breakout boundaries farther away from the underlying donchian extremes and can filter smaller boundary violations.
reducing the padding creates tighter rails and increases sensitivity.
a larger swing pivot length focuses the structure engine on more significant swings. a smaller value provides more detailed short-term structure.
how it can help
breakout detector is designed to reduce the ambiguity around price moving through support or resistance.
instead of treating every penetration as a breakout, it combines structural boundaries with confirmed closing price, candle displacement, relative volume participation, volatility compression, directional flow, lower-timeframe volume behavior, and swing structure.
it can help with:
identifying dynamic breakout boundaries
filtering wick-only rail penetrations
distinguishing simple boundary tests from confirmed displacement
tracking volatility compression before expansion
measuring participation behind a move
visualizing distance to structural levels in atr terms
reading hh, lh, hl, and ll market structure
observing approximate lower-timeframe directional volume
tracking previous confirmed breakout events
creating alerts for confirmed upper and lower breakouts
the indicator also includes a separate compression-start alert and hidden data outputs for the upper rail, lower rail, mid rail, compression score, normalized slope, approximate lower-timeframe delta, and breakout events.
the tool is intended to provide structured market context and breakout confirmation data. it does not predict whether a breakout will continue and does not replace risk management or independent trade analysis.
the indicator is designed around a simple principle: crossing a level is not enough to qualify as a confirmed breakout. the breakout engine requires a confirmed close beyond the previous rail together with sufficient candle displacement and relative volume participation.
rail engine
the upper and lower rails form the core structure of the indicator.
rail length
sets the donchian calculation period used to build the base upper and lower boundaries. shorter values make the rails react faster to recent price action, while longer values create slower structural levels.
rail smoothing
applies ema smoothing to the calculated rails. increasing this value produces smoother and less reactive boundaries.
atr envelope padding
adds an atr-based envelope around the donchian structure. this helps prevent minor price movements around the raw highs and lows from being treated as meaningful structural breaks.
adaptive padding
when enabled, the rail padding automatically adjusts using recent volatility in addition to the base atr padding.
draw rails
shows or hides the upper and lower rail system on the chart.
breakout confirmation
the breakout engine works from the previous confirmed rail values rather than allowing the current breakout candle to move its own threshold.
a confirmed breakout requires three main conditions:
close — price must close beyond the previous rail. wick-only penetration is rejected.
body displacement — the breakout candle must have enough body size relative to the previous atr.
relative volume — current volume must meet the configured participation threshold compared with the previous 50-bar average.
detect confirmed breakouts
enables or disables the breakout engine.
min body displacement
controls the minimum candle body size required for confirmation, expressed as a multiple of atr.
higher values demand stronger displacement. lower values make the detector more sensitive.
min relative volume
defines the minimum participation required for a breakout.
for example, a value of 1.15 requires current volume to reach approximately 1.15 times the reference volume.
breakout history
controls how many confirmed breakout events are retained by the indicator, up to 50.
show breakout markers
displays historical confirmed breakout markers directly at the rail price that triggered each event.
the engine records only one event for each breakout episode. another breakout in the same direction cannot be generated continuously while price remains outside the rail. the engine is re-armed after a confirmed close returns inside the previous rail channel.
compression
the compression engine compares bollinger bands with a keltner channel and also calculates a normalized compression score from recent bollinger bandwidth.
bb / kc length
sets the calculation period used by both systems.
bollinger mult
controls bollinger band width.
keltner mult
controls keltner channel width.
compression field
enables the visual field between the rails when compression conditions become significant.
the institutional panel can display three compression states:
armed — bollinger bands are inside the keltner channel.
charging — compression is elevated according to the bandwidth compression score.
open — no strong compression condition is currently detected.
compression does not represent a breakout by itself. it provides information about volatility contraction that may precede expansion.
market structure
the indicator can automatically identify confirmed swing structure.
hh — higher high
lh — lower high
hl — higher low
ll — lower low
hh / lh / hl / ll
enables or disables structure labels.
swing pivot length
controls how much confirmation is required around a pivot. larger values produce fewer, more significant structural points, while smaller values react to shorter-term swings.
these labels can help determine whether a breakout agrees with the surrounding market structure or is occurring against it.
volume delta
delta gradient on bars
colors candles according to an approximation of directional lower-timeframe volume.
the indicator automatically selects a lower timeframe according to the current chart timeframe and aggregates positive or negative volume based on lower-timeframe candle direction.
positive delta indicates greater estimated bullish directional volume, while negative delta indicates greater estimated bearish directional volume.
this is an approximation derived from lower-timeframe price and volume data. it is not exchange bid/ask footprint delta.
chart visuals
three chart themes are available:
institutional
graphite cyan
graphite gold
rail halo
adds a wider transparent layer around the rails for increased visual separation.
current distance to rails
shows the current distance from price to the upper and lower rails in atr units.
rail grid
adds internal horizontal reference levels between the upper and lower rails.
extend right
controls how far visual rail elements extend beyond the current bar.
institutional panel
the panel provides a compact real-time view of the breakout environment.
engine
shows whether the breakout detector is armed or whether an upper or lower breakout episode is currently active.
regime
classifies the current environment as drift, compression, expansion, breakout up, or breakout down.
upper rail / lower rail
shows each current rail price together with its distance from market price in atr units.
compression
shows the current compression state and normalized compression score.
flow
uses the normalized slope of the rail midpoint to classify directional movement as ascent, descent, or neutral.
participation
shows current relative volume.
ltf delta
shows the approximate lower-timeframe directional volume delta.
last break
displays the direction, age, and rail price of the most recent confirmed breakout.
history
shows how many breakout events are currently stored.
confirmation
reminds the user that breakout confirmation is based on close, body displacement, and relative volume.
the panel can be positioned in any chart corner and displayed in tiny, small, or normal text size.
quick start
start with the default settings and allow the rails to define the current structural price channel.
watch the regime and compression fields. when compression begins to increase, volatility is contracting and the market may be preparing for expansion, although compression alone does not determine direction.
use the upper and lower rails as the active breakout boundaries.
when price approaches a rail, check participation, lower-timeframe delta, flow, and surrounding hh/lh/hl/ll structure for additional context.
a wick through a rail will not produce a confirmed breakout.
for an upper breakout, the candle must close above the previous upper rail, close bullish, meet the minimum body displacement requirement, and satisfy the relative volume threshold.
the opposite conditions apply to a lower breakout.
after confirmation, the breakout is stored in history and marked at the rail level that triggered the event.
the engine remains locked for repeated signals in that direction until price closes back inside the rail channel. this prevents a sequence of candles outside the same boundary from being counted as multiple independent breakouts.
adjusting sensitivity
for stricter breakout confirmation, increase min body displacement and min relative volume. this requires stronger price expansion and participation before an event is accepted.
for more responsive rails, reduce rail length or rail smoothing.
for slower structural rails, increase these values.
increasing atr envelope padding moves the breakout boundaries farther away from the underlying donchian extremes and can filter smaller boundary violations.
reducing the padding creates tighter rails and increases sensitivity.
a larger swing pivot length focuses the structure engine on more significant swings. a smaller value provides more detailed short-term structure.
how it can help
breakout detector is designed to reduce the ambiguity around price moving through support or resistance.
instead of treating every penetration as a breakout, it combines structural boundaries with confirmed closing price, candle displacement, relative volume participation, volatility compression, directional flow, lower-timeframe volume behavior, and swing structure.
it can help with:
identifying dynamic breakout boundaries
filtering wick-only rail penetrations
distinguishing simple boundary tests from confirmed displacement
tracking volatility compression before expansion
measuring participation behind a move
visualizing distance to structural levels in atr terms
reading hh, lh, hl, and ll market structure
observing approximate lower-timeframe directional volume
tracking previous confirmed breakout events
creating alerts for confirmed upper and lower breakouts
the indicator also includes a separate compression-start alert and hidden data outputs for the upper rail, lower rail, mid rail, compression score, normalized slope, approximate lower-timeframe delta, and breakout events.
the tool is intended to provide structured market context and breakout confirmation data. it does not predict whether a breakout will continue and does not replace risk management or independent trade analysis.
Light the candle that sleeps within you.
免责声明
这些信息和出版物并非旨在提供，也不构成TradingView提供或认可的任何形式的财务、投资、交易或其他类型的建议或推荐。请阅读使用条款了解更多信息。
Light the candle that sleeps within you.
免责声明
这些信息和出版物并非旨在提供，也不构成TradingView提供或认可的任何形式的财务、投资、交易或其他类型的建议或推荐。请阅读使用条款了解更多信息。