OPEN-SOURCE SCRIPT
Zaktualizowano Volatility Expansion Planner [AGPro Series]
Volatility Expansion Planner [AGPro Series]
🧠 Core Idea
Is volatility expanding with structure, or is the chart only producing random noise?
📌 Overview / What it does
Volatility Expansion Planner [AGPro Series] is a chart-first volatility expansion and breakout quality tool built to evaluate whether a release from compression has enough structure to deserve active attention.
Instead of showing another generic expansion signal, the script studies ATR expansion, prior range release, close efficiency, volume support, trend alignment, compression age, and the active risk shelf behind the move. These components are converted into a 0-100 Expansion Score and a clear next-action state.
The script produces an expansion corridor, ATR expansion band, prior range edge, risk shelf, compact quality labels, alerts, and a clean AGPro planning panel. It does not predict future price movement, automate decisions, or guarantee that an expansion will continue.
🎯 Purpose & Design Philosophy
This script was built for traders who want to separate structured volatility expansion from unstable noise.
Many volatility tools identify compression, release, or regime changes, but they often stop before answering the practical planning question: is the expansion clean enough to evaluate, and where is the risk reference if the release fails?
The design philosophy is simple: volatility expansion is only useful when it has structure, confirmation, and a readable risk shelf.
⚡ Why This Script Is Different
Most tools focus on squeeze dots, volatility regime labels, ATR readings, or basic breakout markers.
This script does NOT clone a Squeeze Momentum Indicator, does not rebuild an ATR Compression Map, and does not act as a generic breakout signal.
Instead, it evaluates whether expansion is structurally supported. The main output is not a trade command. It is a planning state that helps users distinguish STRUCTURED expansion from WATCH, RISK REVIEW, NOISE, or WAIT conditions.
⚙️ Methodology
1. Context Detection
The script reads the active expansion side using prior range release and trend context, or lets the user force long-side or short-side expansion planning.
2. Reference Mapping
It maps the prior range edge, current ATR expansion, compression age, risk shelf, and projected expansion corridor.
3. Reaction Evaluation
The model scores ATR expansion, range breakout, close efficiency, volume support, trend alignment, compression maturity, and risk shelf quality.
4. Visual Output
The result is displayed through an expansion corridor, ATR band, range edge, risk shelf, compact labels, deterministic alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the expansion corridor shows the projected release path from the prior range edge toward a measured target guide. Its label is centered inside the corridor.
Labels = compact state markers show STRUCTURED, WATCH, RISK REVIEW, NOISE, or SHELF CHECK context.
Colors = green highlights cleaner structured expansion, pink highlights unstable expansion risk, amber highlights review conditions, and indigo highlights watch conditions.
Panel = the panel summarizes Expansion Score, Squeeze Age, Confirmation, Risk Shelf, and Action.
🚦 Signals & States
• STRUCTURED → volatility is expanding with range release, confirmation, and a usable risk shelf.
• WATCH → expansion context is improving but confirmation is incomplete.
• RISK REVIEW → expansion is active but the risk shelf is too tight or too wide for clean planning.
• NOISE → volatility is hot or inefficient and may represent unstable movement.
• WAIT → the script does not detect a strong enough expansion context yet.
• SHELF CHECK → price crossed the prior risk shelf and the expansion context should be reviewed.
🔔 Alerts Logic
Alerts trigger when the planner enters STRUCTURED expansion, WATCH state, NOISE state, RISK REVIEW state, or when price crosses the prior risk shelf.
These alerts are attention markers only. They are not trade instructions, entry signals, or automated strategy commands.
🧩 Confluence Logic
The strongest context appears when ATR expands from a prior compressed structure, price closes beyond the prior range edge, candle efficiency is strong, volume support improves, trend alignment agrees with the expansion side, and the risk shelf remains readable.
When these components align, the Expansion Score improves and the state can move from WATCH to STRUCTURED.
📊 When to Use
• Before evaluating volatility expansion after a quiet range
• During breakout or continuation attempts where expansion quality matters
• When price releases from a prior structure but confirmation is uncertain
• When comparing whether an expansion has clean risk context or only noisy movement
• On liquid symbols where range, volume, and ATR behavior are readable
⚠️ When NOT to Use
• Very low-liquidity symbols with unstable candles
• Extremely noisy micro-timeframes
• News-driven spikes where ATR expands abruptly without structure
• Markets where volume is unreliable and price gaps distort the risk shelf
• Situations where the user expects a signal-only entry tool
🎛️ Key Inputs
• Expansion Side → controls Auto, Long Expansion, or Short Expansion mode.
• Prior Range Lookback → controls how the script maps the range edge before release.
• ATR Baseline → controls how current volatility is compared with normal volatility.
• Minimum Squeeze Age → defines how mature compression should be before stronger expansion scoring.
• Risk Shelf Lookback → controls the shelf used behind the expansion for planning context.
• STRUCTURED Threshold → sets the minimum score required for the strongest state.
• Label and Panel Font Size → controls chart labels, corridor text, and panel readability.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The expansion corridor gives the main visual story. The range edge and risk shelf define the practical planning frame. The ATR band adds volatility context without turning the script into a lower-pane oscillator.
The AGPro panel provides a compact decision summary with a merged blue title row and clear state hierarchy.
🧪 Practical Usage Workflow
1. Read the panel state and Expansion Score.
2. Check whether price is releasing from the prior range edge.
3. Review the risk shelf distance and confirmation state.
4. Compare the expansion corridor with broader structure.
5. Treat alerts as attention markers, then evaluate the broader market context.
🔍 Interpretation Guidelines
Think in terms of expansion quality, not prediction.
A stronger score means multiple structural conditions are aligned. A weaker score means expansion may be premature, poorly confirmed, too hot, or difficult to plan around.
RISK REVIEW is especially important because volatility can expand while the practical risk reference remains too tight, too wide, or unclear.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed signal tool
• Not a Squeeze Momentum clone
• Not an ATR Compression Map clone
⚠️ Limitations & Transparency
The script is rule-based and depends on recent price, volatility, range, and volume behavior.
Timeframe differences can change how compression and expansion appear. Volatility spikes can temporarily distort the score. Symbols with unreliable volume may produce weaker participation readings.
Outputs should always be interpreted with broader market structure and liquidity context.
🧠 Market Context Notes
Volatility expansion is most useful when it appears after a readable compression phase and respects a clear structural shelf.
Expansion without shelf clarity can still move, but it is harder to plan around. Expansion with poor close efficiency or excessive ATR heat can be noisy even when price breaks a range edge.
🧾 Use Case Examples
When price closes beyond a prior range edge with rising ATR, improved volume support, efficient candle structure, and a defined risk shelf, the planner may classify the move as STRUCTURED.
When ATR expands sharply but candles close poorly and the shelf is too far away, the planner may classify the context as NOISE or RISK REVIEW.
🧱 System Philosophy
AGPro planning tools are designed to help traders evaluate context before reacting.
This script follows that philosophy by turning volatility expansion into a structured planning question: Is the release clean, confirmed, and readable enough to deserve attention?
🔐 Non-Promise Statement
No indicator can guarantee continuation, reversal, or follow-through.
This tool provides structured visual context and rule-based attention markers. It does not provide certainty.
📉 Risk Disclosure
Trading involves risk. Market conditions can change quickly, and no script can remove uncertainty.
Users are responsible for their own analysis, risk management, and decisions.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use the planner to study how volatility behaves after compression, how expansion quality changes across timeframes, and how risk shelf clarity affects the readability of a move.
🧠 Core Idea
Is volatility expanding with structure, or is the chart only producing random noise?
📌 Overview / What it does
Volatility Expansion Planner [AGPro Series] is a chart-first volatility expansion and breakout quality tool built to evaluate whether a release from compression has enough structure to deserve active attention.
Instead of showing another generic expansion signal, the script studies ATR expansion, prior range release, close efficiency, volume support, trend alignment, compression age, and the active risk shelf behind the move. These components are converted into a 0-100 Expansion Score and a clear next-action state.
The script produces an expansion corridor, ATR expansion band, prior range edge, risk shelf, compact quality labels, alerts, and a clean AGPro planning panel. It does not predict future price movement, automate decisions, or guarantee that an expansion will continue.
🎯 Purpose & Design Philosophy
This script was built for traders who want to separate structured volatility expansion from unstable noise.
Many volatility tools identify compression, release, or regime changes, but they often stop before answering the practical planning question: is the expansion clean enough to evaluate, and where is the risk reference if the release fails?
The design philosophy is simple: volatility expansion is only useful when it has structure, confirmation, and a readable risk shelf.
⚡ Why This Script Is Different
Most tools focus on squeeze dots, volatility regime labels, ATR readings, or basic breakout markers.
This script does NOT clone a Squeeze Momentum Indicator, does not rebuild an ATR Compression Map, and does not act as a generic breakout signal.
Instead, it evaluates whether expansion is structurally supported. The main output is not a trade command. It is a planning state that helps users distinguish STRUCTURED expansion from WATCH, RISK REVIEW, NOISE, or WAIT conditions.
⚙️ Methodology
1. Context Detection
The script reads the active expansion side using prior range release and trend context, or lets the user force long-side or short-side expansion planning.
2. Reference Mapping
It maps the prior range edge, current ATR expansion, compression age, risk shelf, and projected expansion corridor.
3. Reaction Evaluation
The model scores ATR expansion, range breakout, close efficiency, volume support, trend alignment, compression maturity, and risk shelf quality.
4. Visual Output
The result is displayed through an expansion corridor, ATR band, range edge, risk shelf, compact labels, deterministic alerts, and a premium AGPro panel.
🗺️ How to Read the Chart
Zones = the expansion corridor shows the projected release path from the prior range edge toward a measured target guide. Its label is centered inside the corridor.
Labels = compact state markers show STRUCTURED, WATCH, RISK REVIEW, NOISE, or SHELF CHECK context.
Colors = green highlights cleaner structured expansion, pink highlights unstable expansion risk, amber highlights review conditions, and indigo highlights watch conditions.
Panel = the panel summarizes Expansion Score, Squeeze Age, Confirmation, Risk Shelf, and Action.
🚦 Signals & States
• STRUCTURED → volatility is expanding with range release, confirmation, and a usable risk shelf.
• WATCH → expansion context is improving but confirmation is incomplete.
• RISK REVIEW → expansion is active but the risk shelf is too tight or too wide for clean planning.
• NOISE → volatility is hot or inefficient and may represent unstable movement.
• WAIT → the script does not detect a strong enough expansion context yet.
• SHELF CHECK → price crossed the prior risk shelf and the expansion context should be reviewed.
🔔 Alerts Logic
Alerts trigger when the planner enters STRUCTURED expansion, WATCH state, NOISE state, RISK REVIEW state, or when price crosses the prior risk shelf.
These alerts are attention markers only. They are not trade instructions, entry signals, or automated strategy commands.
🧩 Confluence Logic
The strongest context appears when ATR expands from a prior compressed structure, price closes beyond the prior range edge, candle efficiency is strong, volume support improves, trend alignment agrees with the expansion side, and the risk shelf remains readable.
When these components align, the Expansion Score improves and the state can move from WATCH to STRUCTURED.
📊 When to Use
• Before evaluating volatility expansion after a quiet range
• During breakout or continuation attempts where expansion quality matters
• When price releases from a prior structure but confirmation is uncertain
• When comparing whether an expansion has clean risk context or only noisy movement
• On liquid symbols where range, volume, and ATR behavior are readable
⚠️ When NOT to Use
• Very low-liquidity symbols with unstable candles
• Extremely noisy micro-timeframes
• News-driven spikes where ATR expands abruptly without structure
• Markets where volume is unreliable and price gaps distort the risk shelf
• Situations where the user expects a signal-only entry tool
🎛️ Key Inputs
• Expansion Side → controls Auto, Long Expansion, or Short Expansion mode.
• Prior Range Lookback → controls how the script maps the range edge before release.
• ATR Baseline → controls how current volatility is compared with normal volatility.
• Minimum Squeeze Age → defines how mature compression should be before stronger expansion scoring.
• Risk Shelf Lookback → controls the shelf used behind the expansion for planning context.
• STRUCTURED Threshold → sets the minimum score required for the strongest state.
• Label and Panel Font Size → controls chart labels, corridor text, and panel readability.
🖥️ Interface & Visual Design
The interface is designed to stay chart-first.
The expansion corridor gives the main visual story. The range edge and risk shelf define the practical planning frame. The ATR band adds volatility context without turning the script into a lower-pane oscillator.
The AGPro panel provides a compact decision summary with a merged blue title row and clear state hierarchy.
🧪 Practical Usage Workflow
1. Read the panel state and Expansion Score.
2. Check whether price is releasing from the prior range edge.
3. Review the risk shelf distance and confirmation state.
4. Compare the expansion corridor with broader structure.
5. Treat alerts as attention markers, then evaluate the broader market context.
🔍 Interpretation Guidelines
Think in terms of expansion quality, not prediction.
A stronger score means multiple structural conditions are aligned. A weaker score means expansion may be premature, poorly confirmed, too hot, or difficult to plan around.
RISK REVIEW is especially important because volatility can expand while the practical risk reference remains too tight, too wide, or unclear.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed signal tool
• Not a Squeeze Momentum clone
• Not an ATR Compression Map clone
⚠️ Limitations & Transparency
The script is rule-based and depends on recent price, volatility, range, and volume behavior.
Timeframe differences can change how compression and expansion appear. Volatility spikes can temporarily distort the score. Symbols with unreliable volume may produce weaker participation readings.
Outputs should always be interpreted with broader market structure and liquidity context.
🧠 Market Context Notes
Volatility expansion is most useful when it appears after a readable compression phase and respects a clear structural shelf.
Expansion without shelf clarity can still move, but it is harder to plan around. Expansion with poor close efficiency or excessive ATR heat can be noisy even when price breaks a range edge.
🧾 Use Case Examples
When price closes beyond a prior range edge with rising ATR, improved volume support, efficient candle structure, and a defined risk shelf, the planner may classify the move as STRUCTURED.
When ATR expands sharply but candles close poorly and the shelf is too far away, the planner may classify the context as NOISE or RISK REVIEW.
🧱 System Philosophy
AGPro planning tools are designed to help traders evaluate context before reacting.
This script follows that philosophy by turning volatility expansion into a structured planning question: Is the release clean, confirmed, and readable enough to deserve attention?
🔐 Non-Promise Statement
No indicator can guarantee continuation, reversal, or follow-through.
This tool provides structured visual context and rule-based attention markers. It does not provide certainty.
📉 Risk Disclosure
Trading involves risk. Market conditions can change quickly, and no script can remove uncertainty.
Users are responsible for their own analysis, risk management, and decisions.
This script is for educational and analytical use only and does not provide financial advice.
📚 Educational Note
Use the planner to study how volatility behaves after compression, how expansion quality changes across timeframes, and how risk shelf clarity affects the readability of a move.
Informacje o Wersji
UPDATE NOTES - V1.1This update focuses on readability, volatility-state clarity, panel structure, and chart interpretation.
The core purpose of the script remains unchanged.
This release improves how the existing volatility expansion 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
------------------------
- Refined volatility-state interpretation
The script now makes Active ATR, Cooldown ATR, Noisy ATR, Quiet ATR, and Balanced ATR context easier to read at first glance.
- Reworked workflow language
Panel states now use action-oriented but non-promising review language such as Review expansion, Track confirmation, Check shelf, Reduce noise, Cooldown active, and Wait release.
- Improved centered corridor badge
The expansion corridor now uses a premium centered badge with state, score, and ATR context instead of relying on dense box text.
- Improved label hierarchy
Chart labels are shorter and cleaner, using compact EXP, WATCH, NOISE, SHELF, and COOL language while still showing ATR context.
- Added right-side guide tags
Range edge, risk shelf, and target guide references are easier to identify without adding heavy chart clutter.
- Refined inactive corridor behavior
The forward corridor and target guide now stay hidden during quiet WAIT context so the chart does not imply an active expansion plan when no range release is present.
- Added optional tiny state markers
Diamond state markers are now optional and disabled by default because the main chart story is carried by labels, guides, and the centered corridor badge.
------------------------
Visual Improvements
------------------------
- Improved chart readability by shortening label text and increasing default label spacing
- Reduced visual clutter while keeping enough event history for a useful chart story
- Refined visual hierarchy so the corridor badge, shelf, range edge, and ATR state stand out more clearly
- Adjusted label positioning and default density to reduce overlap with candles
- Improved zone presentation with centered, high-contrast text designed for dark and light chart themes
------------------------
Interface & Usability
------------------------
- Reorganized the panel into a clearer dashboard flow
- Added a dedicated Volatility State row for active, cooldown, noisy, quiet, and balanced ATR context
- Expanded panel location support, including center positions
- Preserved panel show, theme, location, and font controls with publication-ready defaults
- Kept the blue merged panel header as the single title row
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
The goal is to improve clarity and usability, not to introduce new predictive behavior.
Users should interpret outputs the same way as before, but with improved visual structure and clearer volatility-state wording.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, spread, data quality, and timeframe differences may affect how expansion states 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.
Informacje o Wersji
UPDATE NOTES - V1.5This update focuses on first-glance chart polish, label readability, visual hierarchy, and publication-ready defaults.
The core purpose of the script remains unchanged.
This release improves how the existing volatility expansion 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
------------------------
- Default ATR expansion band is now disabled.
This keeps the chart cleaner by default while preserving the optional volatility band feature in settings.
- Corridor transparency was refined.
Expansion corridors now appear lighter by default, helping candles and price structure remain visually dominant.
- Label language was upgraded.
Technical codes such as EXP, WATCH, SHELF, NOISE, and COOL were converted into cleaner chart-facing labels like Expansion, Watch, Shelf Review, Noise, and Cooldown.
- Label density was rebalanced.
Default label cooldown, context spacing, and maximum retained labels were adjusted to reduce clutter without making the chart feel empty.
- Centered guide badges remain active by default.
Range edge, risk shelf, and target guide areas still carry visible premium labels instead of becoming unlabeled zones.
------------------------
Visual Improvements
------------------------
- Reduced visual clutter by removing the heavy ATR cloud from the default publication view
- Improved chart readability by using softer expansion corridors and cleaner label text
- Refined visual hierarchy so candles, active planning guides, and panel context are easier to scan
- Preserved centered zone and guide labels for clearer interpretation of active planning areas
------------------------
Interface & Usability
------------------------
- Kept the AG Pro panel structure unchanged with the merged blue header row
- Preserved panel show / hide, theme, location, and font-size controls
- Preserved label font-size control and applied it consistently to labels and guide badges
- Kept optional advanced visuals available through settings instead of removing features
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
The goal is to improve clarity and usability, not to introduce new predictive behavior.
Users should interpret outputs the same way as before, but with a cleaner default chart presentation.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, and timeframe differences may affect how states 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.
Informacje o Wersji
🔧 UPDATE NOTES - v1.6This update adds an expansion follow-rate proof.
The core purpose of the script remains unchanged.
It continues to evaluate volatility expansion quality with the same range release, ATR,
close-efficiency, volume, trend, compression and risk-shelf model, score and workflow.
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
------------------------
- Follow Rate proof layer
The panel now reports how often structured expansions historically followed through in the plan
direction before reaching the risk shelf or moving against it, shown with the sample count.
- Follow Proof Window input
A new setting controls the window used to measure follow-through.
- Honest, conservative counting
Each structured expansion is counted once, and a crossed risk shelf is treated as a
non-follow-through, so the rate stays realistic on the selected market and timeframe.
- Data window addition
The follow rate is also exposed in the data window alongside the existing component scores.
------------------------
Visual Improvements
------------------------
- Preserved the expansion corridor, range edge, risk shelf and target guides
- Kept centered guide badges with readable contrast on every rail
- Maintained controlled label density and candle-clear offsets
- Left the publication-ready chart layout intact
------------------------
Interface & Usability
------------------------
- Added a Follow Rate row for an at-a-glance follow-through track record
- Added a window setting so the proof measures prompt follow-through
- Kept the existing workflow, volatility, score, squeeze and shelf hierarchy
- Enhanced overall user experience without changing the core expansion logic
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
The expansion score, states, corridor and shelf are unchanged. The Follow Rate is a separate
historical track-record layer and does not alter how expansion quality is computed.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, and timeframe differences may affect how
expansions, the shelf and the rate 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.
Skrypt open-source
W zgodzie z duchem TradingView twórca tego skryptu udostępnił go jako open-source, aby użytkownicy mogli przejrzeć i zweryfikować jego działanie. Ukłony dla autora. Korzystanie jest bezpłatne, jednak ponowna publikacja kodu podlega naszym Zasadom serwisu.
Public-free scripts + invite-only AGPro workflows for market analysis, liquidity context, risk planning and execution review.
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Wyłączenie odpowiedzialności
Informacje i publikacje nie stanowią i nie powinny być traktowane jako porady finansowe, inwestycyjne, tradingowe ani jakiekolwiek inne rekomendacje dostarczane lub zatwierdzone przez TradingView. Więcej informacji znajduje się w Warunkach użytkowania.
Skrypt open-source
W zgodzie z duchem TradingView twórca tego skryptu udostępnił go jako open-source, aby użytkownicy mogli przejrzeć i zweryfikować jego działanie. Ukłony dla autora. Korzystanie jest bezpłatne, jednak ponowna publikacja kodu podlega naszym Zasadom serwisu.
Public-free scripts + invite-only AGPro workflows for market analysis, liquidity context, risk planning and execution review.
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Wyłączenie odpowiedzialności
Informacje i publikacje nie stanowią i nie powinny być traktowane jako porady finansowe, inwestycyjne, tradingowe ani jakiekolwiek inne rekomendacje dostarczane lub zatwierdzone przez TradingView. Więcej informacji znajduje się w Warunkach użytkowania.