OPEN-SOURCE SCRIPT
Güncellendi Volatility Compression Release Map [AGPro Series]
Volatility Compression Release Map [AGPro Series]
🧠 Core Idea
Is the market quietly building expansion energy, or has the release already failed back into the shelf?
📌 Overview / What it does
Volatility Compression Release Map [AGPro Series] is a volatility regime and compression shelf visualization tool built to identify quiet range contraction, release attempts, fake releases, and expansion quality.
The script maps a projected compression shelf when volatility rank and range size contract together. It then tracks whether price releases away from that shelf, returns back inside it, or continues to hold expansion pressure.
This script does not predict future price direction, automate trades, or produce guaranteed buy/sell signals. It is designed as a structured chart-reading layer for volatility compression, release quality, and contextual risk.
🎯 Purpose & Design Philosophy
The script was built for traders who care about the transition between quiet markets and expansion phases.
Many charts look calm before movement starts. The challenge is not simply seeing a tight range, but understanding whether that range is still building energy, whether the release is active, or whether the move has already failed back into the shelf.
The design philosophy is simple: reduce volatility noise into a readable map, preserve the important shelf story, and make the current regime understandable at first glance.
⚡ Why This Script Is Different
Most tools focus on breakout arrows, squeeze dots, or raw volatility bands.
This script does NOT treat every contraction as an immediate trade signal and does NOT frame every expansion candle as confirmation.
Instead, it builds a full compression-to-release map: the shelf, volatility rank, range size, release direction, fake-release risk, quality score, right-side state labels, and a compact AG Pro panel all work together.
⚙️ Methodology
1. Context Detection
The script evaluates ATR rank, recent range size, and whether price is still inside a quiet shelf.
2. Shelf Mapping
When compression conditions align, the active range is stored and projected forward as a compression shelf.
3. Release Evaluation
The script checks whether price leaves the shelf with enough candle body expansion to qualify as a release attempt.
4. Failure Tracking
If price quickly returns into the shelf during the fake-release window, the state changes to fake release.
5. Visual Output
The chart displays a projected shelf, dotted rails, a centered shelf-quality label, event labels, right-side state tags, and a compact AG Pro panel.
🗺️ How to Read the Chart
Zones represent the active compression shelf.
The shelf label shows the current shelf quality score using a compact `SHELF | Q` format.
Green/teal visual states generally indicate constructive expansion or defended release behavior.
Pink visual states highlight failed release or adverse volatility behavior.
Indigo/accent visuals represent compression and neutral shelf structure.
The panel summarizes compression state, release direction, volatility rank, range size, quality score, shelf range, and next context.
🚦 Signals & States
• COMPRESSION BUILD → a quiet shelf is forming and volatility is compressed
• RELEASE ACTIVE → price has moved away from the shelf with sufficient body expansion
• FAKE RELEASE → price returned back into the shelf after a release attempt
• SHELF WATCH → a shelf exists but the market has not produced a clean active release
• WAIT COMPRESSION → no valid compression shelf is currently active
🔔 Alerts Logic
Compression Build alert triggers when a new volatility compression shelf is detected.
Compression Release alert triggers when price releases from the active shelf with enough candle body expansion.
Fake Release alert triggers when price returns back into the shelf within the defined fake-release window.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
The context becomes stronger when low volatility rank, compact range size, a visible shelf, and a strong release candle align.
The context becomes weaker when price fails back into the shelf shortly after release.
📊 When to Use
• Before potential expansion phases
• During quiet range compression
• Around breakout preparation zones
• When evaluating whether a move is expanding or failing
• On liquid markets where volatility structure is meaningful
⚠️ When NOT to Use
• Extremely illiquid symbols
• Very noisy low-timeframe charts
• News shock environments where volatility structure changes suddenly
• Markets with unreliable volume or large gaps
• Situations where a single indicator is being used without broader context
🎛️ Key Inputs
• Compression Lookback → controls the range window used to detect the shelf
• Volatility Rank Lookback → controls how ATR rank is measured
• Compression Rank Max → changes how selective compression detection is
• Range ATR Max → limits how wide a valid shelf can be
• Release Body ATR Min → defines how strong a release candle must be
• Fake Release Window → controls how quickly a release failure is detected
• Visual settings → control shelf projection, labels, panel, theme, and font sizes
🖥️ Interface & Visual Design
The interface is designed to look clean, premium, and publication-ready.
The shelf is the main visual anchor. Event labels are intentionally limited so the chart does not become crowded.
The AG Pro panel uses a merged blue header row and summarizes the state without covering the main chart story.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Locate the active compression shelf.
3. Check whether price is inside, releasing, or failing back into the shelf.
4. Compare the quality score with the visual structure.
5. Use broader market context before making any decision.
🔍 Interpretation Guidelines
Compression is not direction.
A shelf shows where volatility has contracted.
A release shows that price moved away from the shelf with expansion pressure.
A fake release shows that the market rejected the expansion and returned to the compression area.
The strongest interpretations come from combining the shelf, state, quality score, and surrounding market structure.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not guarantee profitable trades.
It does not replace risk management or independent analysis.
⚠️ Limitations & Transparency
Timeframe differences can change how compression and release behavior appears.
High volatility news events may reduce the usefulness of shelf-based interpretation.
Low-liquidity markets can produce misleading shelves and sudden false releases.
The script is rule-based and should always be interpreted within broader market context.
🧠 Market Context Notes
Volatility often contracts before expansion, but compression alone does not define direction.
The shelf helps identify where the market has stored recent range energy.
Release quality helps separate stronger expansion attempts from weak movement outside the range.
🧾 Use Case Examples
When price remains inside a shelf while volatility rank is low, the market may still be building energy.
When price leaves the shelf with strong body expansion, the script marks release behavior.
When price returns into the shelf quickly, the script flags a fake-release context.
🧱 System Philosophy
AGPro Series tools are built to turn complex market behavior into structured visual maps.
The goal is not to simplify markets into certainty, but to make important context easier to read.
🔐 Non-Promise Statement
No script can know the future.
No signal is certain.
No visual state should be treated as a guaranteed outcome.
📉 Risk Disclosure
Trading involves risk.
Markets can move unexpectedly.
Users are responsible for their own decisions, risk management, and trade execution.
This script does not provide financial advice.
📚 Educational Note
This tool is intended for educational and analytical use. It can help traders study volatility compression, release behavior, fake-release risk, and shelf-based market context.
🧠 Core Idea
Is the market quietly building expansion energy, or has the release already failed back into the shelf?
📌 Overview / What it does
Volatility Compression Release Map [AGPro Series] is a volatility regime and compression shelf visualization tool built to identify quiet range contraction, release attempts, fake releases, and expansion quality.
The script maps a projected compression shelf when volatility rank and range size contract together. It then tracks whether price releases away from that shelf, returns back inside it, or continues to hold expansion pressure.
This script does not predict future price direction, automate trades, or produce guaranteed buy/sell signals. It is designed as a structured chart-reading layer for volatility compression, release quality, and contextual risk.
🎯 Purpose & Design Philosophy
The script was built for traders who care about the transition between quiet markets and expansion phases.
Many charts look calm before movement starts. The challenge is not simply seeing a tight range, but understanding whether that range is still building energy, whether the release is active, or whether the move has already failed back into the shelf.
The design philosophy is simple: reduce volatility noise into a readable map, preserve the important shelf story, and make the current regime understandable at first glance.
⚡ Why This Script Is Different
Most tools focus on breakout arrows, squeeze dots, or raw volatility bands.
This script does NOT treat every contraction as an immediate trade signal and does NOT frame every expansion candle as confirmation.
Instead, it builds a full compression-to-release map: the shelf, volatility rank, range size, release direction, fake-release risk, quality score, right-side state labels, and a compact AG Pro panel all work together.
⚙️ Methodology
1. Context Detection
The script evaluates ATR rank, recent range size, and whether price is still inside a quiet shelf.
2. Shelf Mapping
When compression conditions align, the active range is stored and projected forward as a compression shelf.
3. Release Evaluation
The script checks whether price leaves the shelf with enough candle body expansion to qualify as a release attempt.
4. Failure Tracking
If price quickly returns into the shelf during the fake-release window, the state changes to fake release.
5. Visual Output
The chart displays a projected shelf, dotted rails, a centered shelf-quality label, event labels, right-side state tags, and a compact AG Pro panel.
🗺️ How to Read the Chart
Zones represent the active compression shelf.
The shelf label shows the current shelf quality score using a compact `SHELF | Q` format.
Green/teal visual states generally indicate constructive expansion or defended release behavior.
Pink visual states highlight failed release or adverse volatility behavior.
Indigo/accent visuals represent compression and neutral shelf structure.
The panel summarizes compression state, release direction, volatility rank, range size, quality score, shelf range, and next context.
🚦 Signals & States
• COMPRESSION BUILD → a quiet shelf is forming and volatility is compressed
• RELEASE ACTIVE → price has moved away from the shelf with sufficient body expansion
• FAKE RELEASE → price returned back into the shelf after a release attempt
• SHELF WATCH → a shelf exists but the market has not produced a clean active release
• WAIT COMPRESSION → no valid compression shelf is currently active
🔔 Alerts Logic
Compression Build alert triggers when a new volatility compression shelf is detected.
Compression Release alert triggers when price releases from the active shelf with enough candle body expansion.
Fake Release alert triggers when price returns back into the shelf within the defined fake-release window.
Alerts are attention markers. They are not trade instructions.
🧩 Confluence Logic
The context becomes stronger when low volatility rank, compact range size, a visible shelf, and a strong release candle align.
The context becomes weaker when price fails back into the shelf shortly after release.
📊 When to Use
• Before potential expansion phases
• During quiet range compression
• Around breakout preparation zones
• When evaluating whether a move is expanding or failing
• On liquid markets where volatility structure is meaningful
⚠️ When NOT to Use
• Extremely illiquid symbols
• Very noisy low-timeframe charts
• News shock environments where volatility structure changes suddenly
• Markets with unreliable volume or large gaps
• Situations where a single indicator is being used without broader context
🎛️ Key Inputs
• Compression Lookback → controls the range window used to detect the shelf
• Volatility Rank Lookback → controls how ATR rank is measured
• Compression Rank Max → changes how selective compression detection is
• Range ATR Max → limits how wide a valid shelf can be
• Release Body ATR Min → defines how strong a release candle must be
• Fake Release Window → controls how quickly a release failure is detected
• Visual settings → control shelf projection, labels, panel, theme, and font sizes
🖥️ Interface & Visual Design
The interface is designed to look clean, premium, and publication-ready.
The shelf is the main visual anchor. Event labels are intentionally limited so the chart does not become crowded.
The AG Pro panel uses a merged blue header row and summarizes the state without covering the main chart story.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Locate the active compression shelf.
3. Check whether price is inside, releasing, or failing back into the shelf.
4. Compare the quality score with the visual structure.
5. Use broader market context before making any decision.
🔍 Interpretation Guidelines
Compression is not direction.
A shelf shows where volatility has contracted.
A release shows that price moved away from the shelf with expansion pressure.
A fake release shows that the market rejected the expansion and returned to the compression area.
The strongest interpretations come from combining the shelf, state, quality score, and surrounding market structure.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not guarantee profitable trades.
It does not replace risk management or independent analysis.
⚠️ Limitations & Transparency
Timeframe differences can change how compression and release behavior appears.
High volatility news events may reduce the usefulness of shelf-based interpretation.
Low-liquidity markets can produce misleading shelves and sudden false releases.
The script is rule-based and should always be interpreted within broader market context.
🧠 Market Context Notes
Volatility often contracts before expansion, but compression alone does not define direction.
The shelf helps identify where the market has stored recent range energy.
Release quality helps separate stronger expansion attempts from weak movement outside the range.
🧾 Use Case Examples
When price remains inside a shelf while volatility rank is low, the market may still be building energy.
When price leaves the shelf with strong body expansion, the script marks release behavior.
When price returns into the shelf quickly, the script flags a fake-release context.
🧱 System Philosophy
AGPro Series tools are built to turn complex market behavior into structured visual maps.
The goal is not to simplify markets into certainty, but to make important context easier to read.
🔐 Non-Promise Statement
No script can know the future.
No signal is certain.
No visual state should be treated as a guaranteed outcome.
📉 Risk Disclosure
Trading involves risk.
Markets can move unexpectedly.
Users are responsible for their own decisions, risk management, and trade execution.
This script does not provide financial advice.
📚 Educational Note
This tool is intended for educational and analytical use. It can help traders study volatility compression, release behavior, fake-release risk, and shelf-based market context.
Sürüm Notları
🔧 UPDATE NOTES - V1.4This update focuses on restoring the stronger published visual character while keeping the current AGPro Series panel and compile standards intact.
The core purpose of the script remains unchanged.
This release keeps the compression shelf, release labels, and visual personality closer to the stronger published version.
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
------------------------
• Restored the stronger visual baseline
The update returns to the more expressive compression shelf and event-label presentation that looked better on the published chart.
• Removed the overly sterile cleanup direction
The aggressive stale-zone behavior from later test versions was not kept because it made some charts look too empty.
• Preserved the framed shelf structure
The shelf keeps its premium framed zone, soft halo, midpoint rail, and centered badge.
• Fixed Pine function typing
The panel helper now explicitly types the horizontal alignment parameter to avoid the undetermined-type compile warning.
• Kept current panel standards
The panel retains the merged blue header row, configurable location, theme, panel font size, and label font size.
------------------------
Visual Improvements
------------------------
• Restored a fuller chart presence with visible compression and release context
• Kept event labels active enough to avoid an empty chart feel
• Preserved centered shelf text as a separate badge instead of embedded box text
• Maintained contrast-safe label and tag text
• Kept the chart closer to the stronger published visual identity
------------------------
Interface & Usability
------------------------
• Kept Shelf Halo toggle
• Kept Shelf Midline toggle
• Kept Visible Shelf Bars for active-zone footprint control
• Kept Right Tag Offset for compact right-side tag placement
• Kept panel location, panel theme, panel font size, and label font size configurable
------------------------
Behavior Notes
------------------------
This update does not change the core analytical purpose of the script.
The goal is to restore better chart presence, readability, and visual appeal while keeping the script stable.
Users should interpret outputs the same way as before.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, timeframe differences, and range expansion may affect how compression shelves and releases 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.
Sürüm Notları
🔧 UPDATE NOTES - v1.5This update focuses on decision transparency.
The core purpose of the script remains unchanged.
This release adds an honest follow-through statistic so the strength of releases
from a compression shelf is easier to judge at a glance.
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
------------------------
• Stop-Aware Release Follow-Through Rate
A new "Release Rate" panel row reports how often a release expanded one ATR
beyond the shelf edge before returning back inside the compression shelf. A win
means price expanded first and a loss means price returned into the shelf first,
which is the same fake-release idea the engine already tracks, now measured
across history. Releases that resolve neither way inside the window are left
uncounted, and the row shows the sample size and reads "Building" until enough
releases have completed. This adds context to the live quality score without
changing how the score or any state is calculated.
------------------------
Visual Improvements
------------------------
• Added a follow-through context row to the panel for clearer interpretation
• Preserved the existing clean shelf, halo, badge, and right-side tag layout
• Maintained contrast-safe label and tag text as before
• Kept the chart-first presentation uncluttered
------------------------
Interface & Usability
------------------------
• Optimized panel layout with a new release follow-through row
• Improved decision context without changing core logic
• Adjusted nothing in the default visual presentation beyond the added row
• Enhanced overall user experience
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
The compression detection, shelf, release, fake-release, and quality logic
behave the same as before. The Release Rate is an observational statistic only.
Users should interpret outputs the same way as before, but with added
follow-through context.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, and timeframe differences may
affect how compression, releases, and the release rate appear.
The release rate is a historical observation on the current chart and does not
predict future releases. 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.
Açık kaynak kodlu komut dosyası
Gerçek TradingView ruhuyla, bu komut dosyasının mimarı, yatırımcıların işlevselliğini inceleyip doğrulayabilmesi için onu açık kaynaklı hale getirdi. Yazarı tebrik ederiz! Ücretsiz olarak kullanabilseniz de, kodu yeniden yayınlamanın Topluluk Kurallarımıza tabi olduğunu unutmayın.
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
Feragatname
Bilgiler ve yayınlar, TradingView tarafından sağlanan veya onaylanan finansal, yatırım, alım satım veya diğer türden tavsiye veya öneriler anlamına gelmez ve teşkil etmez. Kullanım Koşulları bölümünde daha fazlasını okuyun.
Açık kaynak kodlu komut dosyası
Gerçek TradingView ruhuyla, bu komut dosyasının mimarı, yatırımcıların işlevselliğini inceleyip doğrulayabilmesi için onu açık kaynaklı hale getirdi. Yazarı tebrik ederiz! Ücretsiz olarak kullanabilseniz de, kodu yeniden yayınlamanın Topluluk Kurallarımıza tabi olduğunu unutmayın.
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
Feragatname
Bilgiler ve yayınlar, TradingView tarafından sağlanan veya onaylanan finansal, yatırım, alım satım veya diğer türden tavsiye veya öneriler anlamına gelmez ve teşkil etmez. Kullanım Koşulları bölümünde daha fazlasını okuyun.