OPEN-SOURCE SCRIPT
Aktualisiert Breakout Volume Quality [AGPro Series]
Breakout Volume Quality [AGPro Series]
🔷 OVERVIEW
Breakout Volume Quality is a chart-overlay indicator built to answer one specific question:
When price breaks a defended level, did that break carry real participation quality, or was it only a low-conviction move beyond the line?
Many breakout tools detect the level break itself. This script goes one layer deeper. It evaluates the breakout candle through relative volume, body efficiency, close location, distance beyond the broken level, expansion versus ATR, and the quality of the underlying support-resistance range. The output is a clean 0-100 breakout volume quality score, a visual confirmation band, a compact event label, and a retest state panel.
The goal is not to mark every possible breakout. The goal is to separate a cleaner participation-backed break from a weak level poke that deserves less visual attention.
🔹 CORE IDEA
A breakout is more useful when price does more than cross a line.
Breakout Volume Quality looks for a sequence:
1. A support or resistance reference is built from repeated pivot interaction.
2. Price closes beyond that defended level by an ATR-adjusted buffer.
3. The breakout candle is graded for relative volume participation.
4. Candle structure is checked for efficient body control and directional close quality.
5. The move is measured against ATR to understand displacement and expansion.
6. Confirmed events project a forward confirmation band.
7. The script then tracks whether the broken level produces a clean retest hold, expires, or fades back inside.
This creates a more complete event map than a simple arrow above or below a candle.
💠 UNIQUE EDGE
The edge of this script is the "volume verdict" layer.
It does not simply ask whether price broke resistance or support. It asks whether the break showed enough participation quality to deserve confirmation.
That distinction matters because visually similar breakouts can behave very differently:
- A break with elevated relative volume, strong body efficiency, and a close near the directional extreme usually communicates cleaner participation.
- A break with low relative volume, wick-heavy structure, and a weak close beyond the level may be more fragile.
- A move that breaks, confirms, and later holds the band is visually different from a move that immediately fades back inside.
Breakout Volume Quality turns those differences into a readable score and a structured chart layer.
🔶 WHAT MAKES IT DIFFERENT FROM OTHER AGPRO BREAKOUT TOOLS
This script was intentionally designed to avoid overlapping with the existing AGPro breakout family.
It is not a Donchian breakout tool.
It does not revolve around a rolling channel high or low as the main concept. The level reference comes from defended pivot interaction, and the main evaluation is the volume quality of the break.
It is not an Inside Bar breakout tool.
It does not require a parent candle compression pattern. The script can evaluate broader defended levels rather than only inside-bar structures.
It is not an Opening Range breakout tool.
There is no session opening window, no locked opening range, and no session-specific model.
It is not an ATR Envelope breakout tool.
It does not treat a dynamic volatility envelope as the breakout boundary. ATR is used for normalization, buffers, bands, and score scaling.
It is not a Break-Retest quality tool.
The retest state is included for workflow context, but the core score is assigned to the breakout candle and its participation quality. The first retest is not the central scoring event.
It is not a Failed Break or trap-reclaim tool.
Weak breaks are faded as failed confirmations, but the script does not rebuild the event into a reversal or reclaim model.
It is not a general RVOL pressure map.
Relative volume is used specifically to validate level breaks, not to classify all candles into broad pressure states.
This gives Breakout Volume Quality its own clear lane: breakout participation quality around defended levels.
📌 VISUAL COMPONENTS
Breakout Line
The broken level is extended forward so the user can see the exact structural reference being tested.
Decision Rails
Eligible defended support and resistance references are displayed as subtle forward rails. These rails keep the chart active while price is building around a level, without turning the script into a generic support-resistance map.
Volume Build-Up Windows
Compact boxes labeled BULL SETUP or BEAR SETUP can frame areas where price is building volume pressure near an eligible breakout level before confirmation. These windows are concept-native: they show pre-breakout participation pressure, not generic support-resistance zones.
Optional Advanced Layers
RVOL approach marks, quality candle glow, and pressure trail points are available for users who want more activity on the chart, but they are disabled by default so the main public view remains easy to read.
Confirmation Band
A rectangular band is projected around the broken level. Confirmed events use stronger visual emphasis, while weak confirmations are faded so the chart keeps important context without becoming noisy.
Failed-Confirmation Fade
When price breaks a level but fails the volume, score, candle structure, or close-quality model, the event can still be shown as a softer failed confirmation band. Cleaner weak confirmations can also print WEAK UP or WEAK DOWN labels through a minimum-score filter, so the chart gains more context without labeling every low-quality break.
Retest Hold Label
After a confirmed breakout, the script watches the band for a clean hold. A retest hold is labeled only once so the chart remains controlled.
Summary Panel
The panel displays the current breakout side, volume confirmation, expansion, retest state, and score. It is designed for quick chart reading without covering the price action.
⚙️ SCORING MODEL
The score is built from six components:
Relative Volume
Measures whether current participation is meaningfully above its volume baseline.
Body Efficiency
Measures how much of the candle range is represented by the real body.
Directional Close Location
Checks whether the candle closes toward the breakout side of its own range.
Break Distance
Measures how far the close finishes beyond the broken level in ATR terms.
Expansion
Measures the breakout candle range relative to ATR.
Range Quality
Rewards levels that come from a more defined structure rather than a loose oversized range.
Together, these components produce a transparent 0-100 score and a grade-style readout.
🧭 HOW TO USE
Use the script to study whether a breakout has participation quality.
A stronger event usually has:
- A clean close beyond the level.
- Relative volume above the confirmation threshold.
- A body-dominant candle.
- A close near the breakout-side extreme.
- Meaningful ATR-normalized displacement.
- A confirmation band that later holds during a retest.
A weaker event may show:
- Low relative volume.
- A wick-heavy breakout candle.
- A close barely beyond the level.
- Fast return back inside the broken structure.
- A faded failed-confirmation label instead of a confirmed event.
The script is best used as a structured chart-reading layer. It helps organize breakout quality, but it is not a complete trading system by itself.
🔷 KEY INPUTS
Pivot Strength
Controls how support and resistance references are confirmed.
Minimum Level Touches
Requires repeated interaction before a level becomes eligible.
Level Match Tolerance ATR
Groups nearby pivots into one defended level.
Close Beyond Level ATR
Controls how decisive the break must be beyond the level.
RVOL Confirmation Threshold
Defines the participation level required for volume confirmation.
Minimum Body Efficiency
Filters weak, wick-heavy breakout bars.
Directional Close Location
Requires the candle to close toward the breakout side.
Minimum Score To Confirm
Controls how selective confirmed breakout labels should be.
Confirmation Band ATR
Sets the height of the projected band around the broken level.
Retest Watch Window
Defines how long the script watches for a clean retest hold.
Panel Location / Theme / Font Size
Allows the panel to be adapted to different chart layouts.
Label Font Size / Label Offset
Keeps labels readable and away from candle bodies.
🔶 BEST USE CASE
Breakout Volume Quality works best when the chart has visible defended levels and the user wants a cleaner way to judge whether the break had enough participation behind it.
It is especially useful for:
- Breakouts through repeated swing highs or swing lows.
- Range exits where volume quality matters.
- Comparing strong break candles against weak level pokes.
- Reviewing whether a breakout level later behaves as a confirmation band.
- Keeping weak break attempts visible without giving them the same visual weight as confirmed events.
The script is intentionally restrained: no oversized dashboard, no heavy channel system, no session dependency, and no unnecessary signal spam. The chart stays focused on the level, the break, the volume verdict, and the retest state.
🔹 ALERTS
The script includes alert conditions for:
- Bullish breakout volume confirmation.
- Bearish breakout volume confirmation.
- Breakout failed volume confirmation.
- Breakout retest hold.
- Breakout failed back inside.
These alerts are event prompts for chart review and workflow organization.
💎 DESIGN PHILOSOPHY
Breakout Volume Quality is built to feel clean, premium, and practical on a public TradingView chart.
The visual hierarchy is deliberate:
- Confirmed breaks are visible but not loud.
- Cleaner weak confirmations are faded and labeled through a score filter, while low-quality weak breaks stay visually softer.
- Decision rails keep active levels visible between major events.
- Labeled setup windows explain where pre-breakout volume pressure is forming.
- Optional activity layers are available, but the default chart does not rely on unlabeled dots.
- Bands are long enough to make the level meaningful.
- Retest labels appear only when the state actually changes.
- The panel stays compact and focused on the fields that matter.
The result is a breakout tool that is easy to understand at first glance, but still has enough structure underneath to support serious review.
🔷 OVERVIEW
Breakout Volume Quality is a chart-overlay indicator built to answer one specific question:
When price breaks a defended level, did that break carry real participation quality, or was it only a low-conviction move beyond the line?
Many breakout tools detect the level break itself. This script goes one layer deeper. It evaluates the breakout candle through relative volume, body efficiency, close location, distance beyond the broken level, expansion versus ATR, and the quality of the underlying support-resistance range. The output is a clean 0-100 breakout volume quality score, a visual confirmation band, a compact event label, and a retest state panel.
The goal is not to mark every possible breakout. The goal is to separate a cleaner participation-backed break from a weak level poke that deserves less visual attention.
🔹 CORE IDEA
A breakout is more useful when price does more than cross a line.
Breakout Volume Quality looks for a sequence:
1. A support or resistance reference is built from repeated pivot interaction.
2. Price closes beyond that defended level by an ATR-adjusted buffer.
3. The breakout candle is graded for relative volume participation.
4. Candle structure is checked for efficient body control and directional close quality.
5. The move is measured against ATR to understand displacement and expansion.
6. Confirmed events project a forward confirmation band.
7. The script then tracks whether the broken level produces a clean retest hold, expires, or fades back inside.
This creates a more complete event map than a simple arrow above or below a candle.
💠 UNIQUE EDGE
The edge of this script is the "volume verdict" layer.
It does not simply ask whether price broke resistance or support. It asks whether the break showed enough participation quality to deserve confirmation.
That distinction matters because visually similar breakouts can behave very differently:
- A break with elevated relative volume, strong body efficiency, and a close near the directional extreme usually communicates cleaner participation.
- A break with low relative volume, wick-heavy structure, and a weak close beyond the level may be more fragile.
- A move that breaks, confirms, and later holds the band is visually different from a move that immediately fades back inside.
Breakout Volume Quality turns those differences into a readable score and a structured chart layer.
🔶 WHAT MAKES IT DIFFERENT FROM OTHER AGPRO BREAKOUT TOOLS
This script was intentionally designed to avoid overlapping with the existing AGPro breakout family.
It is not a Donchian breakout tool.
It does not revolve around a rolling channel high or low as the main concept. The level reference comes from defended pivot interaction, and the main evaluation is the volume quality of the break.
It is not an Inside Bar breakout tool.
It does not require a parent candle compression pattern. The script can evaluate broader defended levels rather than only inside-bar structures.
It is not an Opening Range breakout tool.
There is no session opening window, no locked opening range, and no session-specific model.
It is not an ATR Envelope breakout tool.
It does not treat a dynamic volatility envelope as the breakout boundary. ATR is used for normalization, buffers, bands, and score scaling.
It is not a Break-Retest quality tool.
The retest state is included for workflow context, but the core score is assigned to the breakout candle and its participation quality. The first retest is not the central scoring event.
It is not a Failed Break or trap-reclaim tool.
Weak breaks are faded as failed confirmations, but the script does not rebuild the event into a reversal or reclaim model.
It is not a general RVOL pressure map.
Relative volume is used specifically to validate level breaks, not to classify all candles into broad pressure states.
This gives Breakout Volume Quality its own clear lane: breakout participation quality around defended levels.
📌 VISUAL COMPONENTS
Breakout Line
The broken level is extended forward so the user can see the exact structural reference being tested.
Decision Rails
Eligible defended support and resistance references are displayed as subtle forward rails. These rails keep the chart active while price is building around a level, without turning the script into a generic support-resistance map.
Volume Build-Up Windows
Compact boxes labeled BULL SETUP or BEAR SETUP can frame areas where price is building volume pressure near an eligible breakout level before confirmation. These windows are concept-native: they show pre-breakout participation pressure, not generic support-resistance zones.
Optional Advanced Layers
RVOL approach marks, quality candle glow, and pressure trail points are available for users who want more activity on the chart, but they are disabled by default so the main public view remains easy to read.
Confirmation Band
A rectangular band is projected around the broken level. Confirmed events use stronger visual emphasis, while weak confirmations are faded so the chart keeps important context without becoming noisy.
Failed-Confirmation Fade
When price breaks a level but fails the volume, score, candle structure, or close-quality model, the event can still be shown as a softer failed confirmation band. Cleaner weak confirmations can also print WEAK UP or WEAK DOWN labels through a minimum-score filter, so the chart gains more context without labeling every low-quality break.
Retest Hold Label
After a confirmed breakout, the script watches the band for a clean hold. A retest hold is labeled only once so the chart remains controlled.
Summary Panel
The panel displays the current breakout side, volume confirmation, expansion, retest state, and score. It is designed for quick chart reading without covering the price action.
⚙️ SCORING MODEL
The score is built from six components:
Relative Volume
Measures whether current participation is meaningfully above its volume baseline.
Body Efficiency
Measures how much of the candle range is represented by the real body.
Directional Close Location
Checks whether the candle closes toward the breakout side of its own range.
Break Distance
Measures how far the close finishes beyond the broken level in ATR terms.
Expansion
Measures the breakout candle range relative to ATR.
Range Quality
Rewards levels that come from a more defined structure rather than a loose oversized range.
Together, these components produce a transparent 0-100 score and a grade-style readout.
🧭 HOW TO USE
Use the script to study whether a breakout has participation quality.
A stronger event usually has:
- A clean close beyond the level.
- Relative volume above the confirmation threshold.
- A body-dominant candle.
- A close near the breakout-side extreme.
- Meaningful ATR-normalized displacement.
- A confirmation band that later holds during a retest.
A weaker event may show:
- Low relative volume.
- A wick-heavy breakout candle.
- A close barely beyond the level.
- Fast return back inside the broken structure.
- A faded failed-confirmation label instead of a confirmed event.
The script is best used as a structured chart-reading layer. It helps organize breakout quality, but it is not a complete trading system by itself.
🔷 KEY INPUTS
Pivot Strength
Controls how support and resistance references are confirmed.
Minimum Level Touches
Requires repeated interaction before a level becomes eligible.
Level Match Tolerance ATR
Groups nearby pivots into one defended level.
Close Beyond Level ATR
Controls how decisive the break must be beyond the level.
RVOL Confirmation Threshold
Defines the participation level required for volume confirmation.
Minimum Body Efficiency
Filters weak, wick-heavy breakout bars.
Directional Close Location
Requires the candle to close toward the breakout side.
Minimum Score To Confirm
Controls how selective confirmed breakout labels should be.
Confirmation Band ATR
Sets the height of the projected band around the broken level.
Retest Watch Window
Defines how long the script watches for a clean retest hold.
Panel Location / Theme / Font Size
Allows the panel to be adapted to different chart layouts.
Label Font Size / Label Offset
Keeps labels readable and away from candle bodies.
🔶 BEST USE CASE
Breakout Volume Quality works best when the chart has visible defended levels and the user wants a cleaner way to judge whether the break had enough participation behind it.
It is especially useful for:
- Breakouts through repeated swing highs or swing lows.
- Range exits where volume quality matters.
- Comparing strong break candles against weak level pokes.
- Reviewing whether a breakout level later behaves as a confirmation band.
- Keeping weak break attempts visible without giving them the same visual weight as confirmed events.
The script is intentionally restrained: no oversized dashboard, no heavy channel system, no session dependency, and no unnecessary signal spam. The chart stays focused on the level, the break, the volume verdict, and the retest state.
🔹 ALERTS
The script includes alert conditions for:
- Bullish breakout volume confirmation.
- Bearish breakout volume confirmation.
- Breakout failed volume confirmation.
- Breakout retest hold.
- Breakout failed back inside.
These alerts are event prompts for chart review and workflow organization.
💎 DESIGN PHILOSOPHY
Breakout Volume Quality is built to feel clean, premium, and practical on a public TradingView chart.
The visual hierarchy is deliberate:
- Confirmed breaks are visible but not loud.
- Cleaner weak confirmations are faded and labeled through a score filter, while low-quality weak breaks stay visually softer.
- Decision rails keep active levels visible between major events.
- Labeled setup windows explain where pre-breakout volume pressure is forming.
- Optional activity layers are available, but the default chart does not rely on unlabeled dots.
- Bands are long enough to make the level meaningful.
- Retest labels appear only when the state actually changes.
- The panel stays compact and focused on the fields that matter.
The result is a breakout tool that is easy to understand at first glance, but still has enough structure underneath to support serious review.
Versionshinweise
🔧 UPDATE NOTES - V1.1This update focuses on readability, visual hierarchy, label balance, panel structure, and publication-quality breakout context.
The core purpose of the script remains unchanged.
This release improves how the existing breakout volume quality logic is presented, organized, and interpreted on the chart.
This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.
------------------------
What Changed
------------------------
• Reworked the breakout visual map.
The script still evaluates structural breaks using relative volume, body efficiency, close location, displacement, range expansion, and structure quality.
• Added a cleaner confirmation band system.
Confirmed and selected weak breakout events now use compact forward bands with centered labels inside the band.
• Reduced default label clutter.
Weak breakout visuals and labels are disabled by default, historical event objects are capped more tightly, and label density can be controlled from the settings.
• Refined setup window behavior.
Volume build-up windows are now more selective by default and use centered setup labels inside the window.
• Updated naming and panel standards.
The public script title no longer starts with AG Pro, while the panel title keeps the AG Pro branding. The panel header remains a single merged blue row.
------------------------
Visual Improvements
------------------------
• Improved chart readability by adjusting breakout labels, confirmation bands, decision rails, and setup windows.
• Reduced visual clutter to enhance first-glance interpretation.
• Refined visual hierarchy so confirmed breaks, weak attempts, retest states, and setup pressure are easier to separate.
• Adjusted positioning of elements to avoid overlap with candles.
• Added centered labels inside confirmation bands and setup windows.
------------------------
Interface & Usability
------------------------
• Optimized panel layout for clearer information flow.
• Improved label readability for better chart interaction.
• Adjusted default visual settings for a more balanced appearance.
• Disabled weak confirmation visuals by default so the initial chart view emphasizes cleaner confirmed events and setup context.
• Added configurable label font size and panel font size with Normal as the default.
• Added panel location and theme controls while keeping the panel visible by default.
• Simplified the panel into the most important live context: breakout side, volume, expansion, retest state, score, and visual map state.
• Added a Best View panel row to guide users toward the recommended 4H chart view for cleaner visual interpretation.
• Added an automatic low-timeframe showcase guard.
Charts below 4H now reduce secondary visual layers by default and show a clearer panel note recommending the 4H chart view.
------------------------
Behavior Notes
------------------------
This update does not change the core analytical purpose of the script.
The goal is to improve clarity and usability, not to introduce predictive behavior.
Users should interpret outputs the same way as before, but with improved visual structure, cleaner label density, and more readable breakout confirmation context.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, timeframe differences, and symbol-specific volume behavior may affect how breakout quality appears.
Outputs should always be interpreted within broader market context.
------------------------
Risk Reminder
------------------------
This script is for educational and analytical purposes only.
It does not provide financial advice or guaranteed trading outcomes.
Users remain responsible for their own decisions.
Versionshinweise
UPDATE NOTES - v1.2This update focuses on label presentation and readability.
The core purpose of the script remains unchanged. This release improves how the
existing breakout bands, event labels, setup windows, and panel read on the
chart, with a cleaner and more consistent label style.
This script continues to function as an analytical and visualization tool. It
does not attempt to predict price direction or provide guaranteed outcomes.
------------------------
What Changed
------------------------
- Title Case labels throughout
Confirmation band labels, breakout event labels, retest and fade labels, and
setup window labels now use clean Title Case styling (Bull Confirm, BVQ Up,
Hold, Fade, Bull Setup) for a more premium and consistent look.
- Band and setup badges moved off the candles
Confirmation band labels and setup window labels now sit at the right edge of
their box and stay vertically centered, instead of floating in the middle
where they could overlap candles and become hard to read.
- Theme-aware text everywhere
Band labels, event labels, retest and fade labels, setup labels, and every
colored panel value now choose a text color that reads clearly on both light
and dark backgrounds, using a brightness-accurate method so mint, pink, amber,
indigo, and grey all stay readable.
------------------------
Visual Improvements
------------------------
- Consistent Title Case styling for all on-chart labels.
- Band and setup badges sit at the right edge of their boxes, away from the
candles.
- Contrast-safe band, event, retest, setup, and panel text on both themes.
- Preserved the familiar structure level, decision rail, band, and setup window
layout.
------------------------
Interface & Usability
------------------------
- Cleaner, more readable band, event, and setup labeling.
- Improved panel contrast across all rows on both themes.
- Adjusted default visual presentation for a more balanced, premium appearance.
- Enhanced overall user experience without changing core logic.
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
The pivot structure mapping, the relative-volume and candle-efficiency scoring,
the breakout confirmation model, the retest and failure tracking, the volume
build-up windows, and the panel statistics all behave exactly as before.
Users should interpret outputs the same way as before, but with cleaner labels
and a more readable presentation.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, and timeframe differences may
affect how breakouts and bands appear. Outputs should always be interpreted
within broader market context.
------------------------
Risk Reminder
------------------------
This script is for educational and analytical purposes only.
It does not provide financial advice or guaranteed trading outcomes. Users
remain responsible for their own decisions.
Open-source Skript
Ganz im Sinne von TradingView hat dieser Autor sein/ihr Script als Open-Source veröffentlicht. Auf diese Weise können nun auch andere Trader das Script rezensieren und die Funktionalität überprüfen. Vielen Dank an den Autor! Sie können das Script kostenlos verwenden, aber eine Wiederveröffentlichung des Codes unterliegt unseren Hausregeln.
Public-free and invite-only TradingView Pine Script tools for market analysis, risk planning, liquidity and execution review.
Script library & access: aligurtuna.com/agprolabs-pine-scriptleri/
Telegram: t.me/agprolabs
Script library & access: aligurtuna.com/agprolabs-pine-scriptleri/
Telegram: t.me/agprolabs
Haftungsausschluss
Die Informationen und Veröffentlichungen sind nicht als Finanz-, Anlage-, Handels- oder andere Arten von Ratschlägen oder Empfehlungen gedacht, die von TradingView bereitgestellt oder gebilligt werden, und stellen diese nicht dar. Lesen Sie mehr in den Nutzungsbedingungen.
Open-source Skript
Ganz im Sinne von TradingView hat dieser Autor sein/ihr Script als Open-Source veröffentlicht. Auf diese Weise können nun auch andere Trader das Script rezensieren und die Funktionalität überprüfen. Vielen Dank an den Autor! Sie können das Script kostenlos verwenden, aber eine Wiederveröffentlichung des Codes unterliegt unseren Hausregeln.
Public-free and invite-only TradingView Pine Script tools for market analysis, risk planning, liquidity and execution review.
Script library & access: aligurtuna.com/agprolabs-pine-scriptleri/
Telegram: t.me/agprolabs
Script library & access: aligurtuna.com/agprolabs-pine-scriptleri/
Telegram: t.me/agprolabs
Haftungsausschluss
Die Informationen und Veröffentlichungen sind nicht als Finanz-, Anlage-, Handels- oder andere Arten von Ratschlägen oder Empfehlungen gedacht, die von TradingView bereitgestellt oder gebilligt werden, und stellen diese nicht dar. Lesen Sie mehr in den Nutzungsbedingungen.