OPEN-SOURCE SCRIPT
Aggiornato Liquidity Vacuum Recovery Map [AGPro Series]
Liquidity Vacuum Recovery Map [AGPro Series]
🧠 Core Idea
Did price leave a liquidity vacuum, and is the market repairing that vacuum or rejecting the repair attempt?
📌 Overview / What it does
Liquidity Vacuum Recovery Map is a price-action visualization tool built to study displacement, imbalance, liquidity void behavior, and repair progress after a strong directional candle.
The script identifies high-quality displacement candles, builds an active vacuum zone from the body of that move, tracks how deeply price revisits the zone, measures repair progress, highlights rejection risk, and summarizes the full recovery context inside a compact AG Pro panel.
It does not predict future price, automate trades, or claim that every vacuum must be filled. It is a structured map for reading whether a thin participation area is still open, partially repaired, fully repaired, or being rejected.
🎯 Purpose & Design Philosophy
Many traders can see a fast displacement move after it happens.
The harder question is what comes next:
Is the market repairing the move, respecting the void, or rejecting the return into that area?
This script was built to answer that question visually. It helps traders read imbalance recovery, repair quality, rejection pressure, and next-context conditions without turning the chart into a generic signal board.
⚡ Why This Script Is Different
Most liquidity void tools focus on drawing static gaps, imbalance boxes, or historical void areas.
This script does NOT treat a vacuum as a passive rectangle on the chart.
Instead, it tracks the life cycle of the vacuum after displacement: creation, first repair, half repair, full repair, and rejection risk. The focus is not only where the vacuum is. The focus is whether the market is actively repairing it or refusing to repair it.
⚙️ Methodology
1. Displacement Detection
The script reviews candle range expansion, candle body commitment, close drive, and volume participation to identify a meaningful displacement candle.
2. Vacuum Zone Mapping
When the displacement qualifies, the script builds a vacuum zone from the strongest portion of the candle body. Bullish displacement leaves a repair zone below price. Bearish displacement leaves a repair zone above price.
3. Repair Progress Tracking
The script tracks how far price penetrates back into the active vacuum zone and converts that movement into a repair progress percentage.
4. Rejection Evaluation
If price enters the zone but moves away before full repair, the script evaluates whether the repair attempt is being rejected.
5. Quality Scoring
Vacuum quality combines range expansion, body commitment, close drive, and volume participation into a 0-100 score.
6. Visual Output
The chart displays the active vacuum zone, repair progress fill, midpoint reference, right-side repair tags, event labels, alerts, and a compact AG Pro decision panel.
🗺️ How to Read the Chart
Liquidity Vacuum Zone = the thin participation area left behind by a strong displacement candle.
Repair Progress Fill = the portion of the vacuum that price has already revisited.
VAC HIGH / VAC LOW = the active upper and lower boundaries of the vacuum zone.
REPAIR tag = the current repair progress score on the right side of the chart.
VACUUM OPEN = a qualified vacuum exists, but repair has not meaningfully started.
REPAIRING = price has started revisiting the vacuum zone.
REPAIR COMPLETE = price has repaired most or all of the active vacuum.
REJECTION RISK = price entered the vacuum zone but moved away before full repair.
Panel = summarizes vacuum state, quality score, vacuum type, repair progress, rejection risk, target zone, and next context.
🚦 Signals & States
• BULL VACUUM LEFT → bullish displacement created a vacuum below price.
• BEAR VACUUM LEFT → bearish displacement created a vacuum above price.
• REPAIR START → price has started entering the active vacuum zone.
• REPAIR HALF → price has repaired at least half of the active vacuum zone.
• REPAIR COMPLETE → price has repaired most or all of the active vacuum zone.
• REPAIR REJECTION → price entered the vacuum zone but rejected away before full repair.
🔔 Alerts Logic
Alerts can trigger when a qualified vacuum is created, repair starts, half repair is reached, full repair is reached, or repair rejection appears.
These alerts are attention markers only.
They are not trade instructions, entry signals, exit signals, or guaranteed outcomes.
🧩 Confluence Logic
The context becomes stronger when a high-quality displacement candle creates a clear vacuum, price revisits the zone, repair progress reaches a meaningful threshold, and rejection risk remains low.
The context becomes weaker when the vacuum is old, repair progress is incomplete, and price repeatedly rejects away from the zone.
📊 When to Use
• After strong displacement candles
• During imbalance and liquidity void analysis
• Around fast breakout or breakdown moves
• When evaluating whether a move is being repaired
• When studying continuation versus retracement behavior
• On liquid markets where candles and volume are meaningful
⚠️ When NOT to Use
• In extremely low-liquidity markets
• During highly erratic news candles
• On symbols with unreliable volume data
• When price is moving in tiny noisy candles without displacement
• As a standalone buy or sell system
🎛️ Key Inputs
• Minimum Displacement Range → controls how large a candle must be relative to average range.
• Minimum Body / Range → controls how committed the displacement candle body must be.
• Minimum Close Drive → controls how strongly the candle must close toward its direction.
• Vacuum Zone Body Share → controls how deep the vacuum zone is drawn inside the displacement body.
• Repair Start / Half / Complete Percent → controls the repair progress thresholds.
• Rejection Buffer ATR → controls how far price must move away before rejection risk is detected.
• Projection Bars → controls how far the active zone extends to the right.
• Label and Panel Font Size → controls chart readability.
🖥️ Interface & Visual Design
The visual design is built around one active story:
Where is the vacuum, how much of it has been repaired, and what is the current repair state?
The zone creates the main map, the repair fill shows progress, right-side tags keep the structure readable, event labels mark important moments, and the AG Pro panel summarizes the decision context.
🧪 Practical Usage Workflow
1. Read the panel first.
2. Check whether the script shows an active vacuum.
3. Review the vacuum quality score.
4. Look at repair progress.
5. Check whether rejection risk is low, medium, or high.
6. Use the vacuum boundaries as context areas, not automatic trade levels.
7. Confirm the broader market structure independently.
🔍 Interpretation Guidelines
A vacuum left behind by strong displacement can remain open for a long time.
Repair progress means price has revisited part of the zone.
Full repair means the active vacuum has mostly been revisited.
Rejection risk means the market attempted to repair the zone but moved away before completing the repair.
None of these states guarantee what happens next.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not a financial advice tool.
It is not an automated trading system.
It does not guarantee that price will fill a vacuum.
It does not guarantee continuation after rejection.
It does not replace risk management or independent analysis.
⚠️ Limitations & Transparency
Vacuum detection depends on candle behavior, volatility, volume, and timeframe.
Different timeframes may show different vacuum structures.
Some markets repair quickly, while others leave open void areas for long periods.
Volume-based scoring may be less reliable on symbols with incomplete or synthetic volume.
High volatility can create visually large zones that should be interpreted with extra caution.
🧠 Market Context Notes
Liquidity vacuums are most useful when interpreted as participation gaps rather than guaranteed magnets.
A repaired vacuum can signal that the market revisited a prior thin area.
A rejected vacuum can signal that the market respected the displacement path and refused deeper repair.
The best interpretation comes from combining vacuum context with structure, volatility, liquidity, and higher-timeframe conditions.
🧾 Use Case Examples
When price leaves a strong bullish displacement candle and later returns into the vacuum zone, traders can monitor whether repair progress increases smoothly or gets rejected near the upper part of the zone.
When price leaves a strong bearish displacement candle and later returns into the vacuum zone, traders can monitor whether the market fully repairs the move or rejects back below the zone.
When repair progress reaches half repair but rejection risk rises, the active context may become more fragile.
🧱 System Philosophy
Liquidity Vacuum Recovery Map is part of the AGPro Series approach:
Build visual tools that explain market context clearly, avoid hype, avoid prediction claims, and support structured decision-making.
The goal is not to tell users what to do.
The goal is to help users see what the market is doing more clearly.
🔐 Non-Promise Statement
No script can remove uncertainty from trading.
This tool does not promise accuracy, certainty, profitability, or future performance.
📉 Risk Disclosure
Trading involves risk.
Market conditions can change quickly.
Users are responsible for their own decisions, position sizing, risk management, and interpretation.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use this script as a structured way to study displacement, liquidity vacuum behavior, repair progress, and rejection context.
The most valuable output is not a single label.
The value is the full map: vacuum, repair, rejection, quality, and next context.
🧠 Core Idea
Did price leave a liquidity vacuum, and is the market repairing that vacuum or rejecting the repair attempt?
📌 Overview / What it does
Liquidity Vacuum Recovery Map is a price-action visualization tool built to study displacement, imbalance, liquidity void behavior, and repair progress after a strong directional candle.
The script identifies high-quality displacement candles, builds an active vacuum zone from the body of that move, tracks how deeply price revisits the zone, measures repair progress, highlights rejection risk, and summarizes the full recovery context inside a compact AG Pro panel.
It does not predict future price, automate trades, or claim that every vacuum must be filled. It is a structured map for reading whether a thin participation area is still open, partially repaired, fully repaired, or being rejected.
🎯 Purpose & Design Philosophy
Many traders can see a fast displacement move after it happens.
The harder question is what comes next:
Is the market repairing the move, respecting the void, or rejecting the return into that area?
This script was built to answer that question visually. It helps traders read imbalance recovery, repair quality, rejection pressure, and next-context conditions without turning the chart into a generic signal board.
⚡ Why This Script Is Different
Most liquidity void tools focus on drawing static gaps, imbalance boxes, or historical void areas.
This script does NOT treat a vacuum as a passive rectangle on the chart.
Instead, it tracks the life cycle of the vacuum after displacement: creation, first repair, half repair, full repair, and rejection risk. The focus is not only where the vacuum is. The focus is whether the market is actively repairing it or refusing to repair it.
⚙️ Methodology
1. Displacement Detection
The script reviews candle range expansion, candle body commitment, close drive, and volume participation to identify a meaningful displacement candle.
2. Vacuum Zone Mapping
When the displacement qualifies, the script builds a vacuum zone from the strongest portion of the candle body. Bullish displacement leaves a repair zone below price. Bearish displacement leaves a repair zone above price.
3. Repair Progress Tracking
The script tracks how far price penetrates back into the active vacuum zone and converts that movement into a repair progress percentage.
4. Rejection Evaluation
If price enters the zone but moves away before full repair, the script evaluates whether the repair attempt is being rejected.
5. Quality Scoring
Vacuum quality combines range expansion, body commitment, close drive, and volume participation into a 0-100 score.
6. Visual Output
The chart displays the active vacuum zone, repair progress fill, midpoint reference, right-side repair tags, event labels, alerts, and a compact AG Pro decision panel.
🗺️ How to Read the Chart
Liquidity Vacuum Zone = the thin participation area left behind by a strong displacement candle.
Repair Progress Fill = the portion of the vacuum that price has already revisited.
VAC HIGH / VAC LOW = the active upper and lower boundaries of the vacuum zone.
REPAIR tag = the current repair progress score on the right side of the chart.
VACUUM OPEN = a qualified vacuum exists, but repair has not meaningfully started.
REPAIRING = price has started revisiting the vacuum zone.
REPAIR COMPLETE = price has repaired most or all of the active vacuum.
REJECTION RISK = price entered the vacuum zone but moved away before full repair.
Panel = summarizes vacuum state, quality score, vacuum type, repair progress, rejection risk, target zone, and next context.
🚦 Signals & States
• BULL VACUUM LEFT → bullish displacement created a vacuum below price.
• BEAR VACUUM LEFT → bearish displacement created a vacuum above price.
• REPAIR START → price has started entering the active vacuum zone.
• REPAIR HALF → price has repaired at least half of the active vacuum zone.
• REPAIR COMPLETE → price has repaired most or all of the active vacuum zone.
• REPAIR REJECTION → price entered the vacuum zone but rejected away before full repair.
🔔 Alerts Logic
Alerts can trigger when a qualified vacuum is created, repair starts, half repair is reached, full repair is reached, or repair rejection appears.
These alerts are attention markers only.
They are not trade instructions, entry signals, exit signals, or guaranteed outcomes.
🧩 Confluence Logic
The context becomes stronger when a high-quality displacement candle creates a clear vacuum, price revisits the zone, repair progress reaches a meaningful threshold, and rejection risk remains low.
The context becomes weaker when the vacuum is old, repair progress is incomplete, and price repeatedly rejects away from the zone.
📊 When to Use
• After strong displacement candles
• During imbalance and liquidity void analysis
• Around fast breakout or breakdown moves
• When evaluating whether a move is being repaired
• When studying continuation versus retracement behavior
• On liquid markets where candles and volume are meaningful
⚠️ When NOT to Use
• In extremely low-liquidity markets
• During highly erratic news candles
• On symbols with unreliable volume data
• When price is moving in tiny noisy candles without displacement
• As a standalone buy or sell system
🎛️ Key Inputs
• Minimum Displacement Range → controls how large a candle must be relative to average range.
• Minimum Body / Range → controls how committed the displacement candle body must be.
• Minimum Close Drive → controls how strongly the candle must close toward its direction.
• Vacuum Zone Body Share → controls how deep the vacuum zone is drawn inside the displacement body.
• Repair Start / Half / Complete Percent → controls the repair progress thresholds.
• Rejection Buffer ATR → controls how far price must move away before rejection risk is detected.
• Projection Bars → controls how far the active zone extends to the right.
• Label and Panel Font Size → controls chart readability.
🖥️ Interface & Visual Design
The visual design is built around one active story:
Where is the vacuum, how much of it has been repaired, and what is the current repair state?
The zone creates the main map, the repair fill shows progress, right-side tags keep the structure readable, event labels mark important moments, and the AG Pro panel summarizes the decision context.
🧪 Practical Usage Workflow
1. Read the panel first.
2. Check whether the script shows an active vacuum.
3. Review the vacuum quality score.
4. Look at repair progress.
5. Check whether rejection risk is low, medium, or high.
6. Use the vacuum boundaries as context areas, not automatic trade levels.
7. Confirm the broader market structure independently.
🔍 Interpretation Guidelines
A vacuum left behind by strong displacement can remain open for a long time.
Repair progress means price has revisited part of the zone.
Full repair means the active vacuum has mostly been revisited.
Rejection risk means the market attempted to repair the zone but moved away before completing the repair.
None of these states guarantee what happens next.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not a financial advice tool.
It is not an automated trading system.
It does not guarantee that price will fill a vacuum.
It does not guarantee continuation after rejection.
It does not replace risk management or independent analysis.
⚠️ Limitations & Transparency
Vacuum detection depends on candle behavior, volatility, volume, and timeframe.
Different timeframes may show different vacuum structures.
Some markets repair quickly, while others leave open void areas for long periods.
Volume-based scoring may be less reliable on symbols with incomplete or synthetic volume.
High volatility can create visually large zones that should be interpreted with extra caution.
🧠 Market Context Notes
Liquidity vacuums are most useful when interpreted as participation gaps rather than guaranteed magnets.
A repaired vacuum can signal that the market revisited a prior thin area.
A rejected vacuum can signal that the market respected the displacement path and refused deeper repair.
The best interpretation comes from combining vacuum context with structure, volatility, liquidity, and higher-timeframe conditions.
🧾 Use Case Examples
When price leaves a strong bullish displacement candle and later returns into the vacuum zone, traders can monitor whether repair progress increases smoothly or gets rejected near the upper part of the zone.
When price leaves a strong bearish displacement candle and later returns into the vacuum zone, traders can monitor whether the market fully repairs the move or rejects back below the zone.
When repair progress reaches half repair but rejection risk rises, the active context may become more fragile.
🧱 System Philosophy
Liquidity Vacuum Recovery Map is part of the AGPro Series approach:
Build visual tools that explain market context clearly, avoid hype, avoid prediction claims, and support structured decision-making.
The goal is not to tell users what to do.
The goal is to help users see what the market is doing more clearly.
🔐 Non-Promise Statement
No script can remove uncertainty from trading.
This tool does not promise accuracy, certainty, profitability, or future performance.
📉 Risk Disclosure
Trading involves risk.
Market conditions can change quickly.
Users are responsible for their own decisions, position sizing, risk management, and interpretation.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use this script as a structured way to study displacement, liquidity vacuum behavior, repair progress, and rejection context.
The most valuable output is not a single label.
The value is the full map: vacuum, repair, rejection, quality, and next context.
Note di rilascio
🔧 UPDATE NOTES - 1.1This update focuses on chart readability, zone-label structure, panel consistency, and visual control.
The core purpose of the script remains unchanged.
This release improves how the existing liquidity-vacuum recovery 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 vacuum-zone text into separate centered badges.
Liquidity Vacuum and Repair Path text now uses dedicated labels instead of zone text payloads.
• Added Show Centered Zone Badges.
Users can hide or show the centered vacuum and repair badges without changing the core zone logic.
• Added Adaptive HTF Projection.
The visual projection expands on higher timeframes so active vacuum zones remain easier to read.
• Expanded panel controls.
The panel now supports Elite Dark, Slate, and Clean Light themes, expanded location options, and live position updates.
• Expanded font-size controls.
Label and panel font-size inputs now include Huge, and chart labels, centered badges, right-side tags, and panel text follow the configured settings.
• Refined panel rendering.
The panel header uses the standard single merged blue row with only the script name.
------------------------
Visual Improvements
------------------------
• Improved chart readability by separating zone text from transparent vacuum and repair objects.
• Improved contrast by placing important text inside dedicated badges.
• Reduced right-side visual pressure while preserving vacuum high, vacuum low, and repair tags.
• Refined visual hierarchy so vacuum state, repair progress, rejection risk, and panel context are easier to scan.
------------------------
Interface & Usability
------------------------
• Panel show/hide remains available and enabled by default.
• Panel theme, location, and font size remain user-adjustable.
• The panel location now updates live through table positioning.
• Zone badges and label-size controls provide clearer chart customization.
------------------------
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 cleaner zone structure and more controlled visual density.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Vacuum quality, repair progress, rejection risk, and target-zone context can vary across symbols, timeframes, volatility conditions, and liquidity conditions.
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.
Note di rilascio
🔧 UPDATE NOTES - v1.3This update focuses on label contrast and on-chart overlap cleanup.
The core purpose of the script remains unchanged. It still detects strong
displacement candles that leave a thin participation area behind, builds a live
vacuum zone, tracks repair progress, and summarizes repair, rejection risk,
target area, vacuum type and a 0-100 quality score in the AG Pro panel.
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
------------------------
• Contrast-aware text on every colored element
Text color is now derived from each element's actual background luminance, for
the vacuum and repair centered badges, the VAC HIGH / VAC LOW right-side tags,
the vacuum / repair / rejection event labels, and the panel header. Previously
these used light text on the brighter amber (half-repair), pink (bear / VAC HIGH
/ rejection) and indigo (repair-start) backgrounds, which read faintly. Every
label now reads crisply.
• Non-overlapping event labels
Event labels (vacuum, repair start / half / done, rejection) now check against
recent event labels and shift vertically when they would land on top of each
other. This removes the stacked-label overlap that could appear when two repair
events occurred close together.
• Removed redundant right-side repair tag
The right-side "REPAIR %" tag was removed because repair progress is already
shown in the centered vacuum badge and in the panel (Repair Progress row). This
clears the crowding between the VAC HIGH, VAC LOW and repair tags on the right
edge, especially on thinner vacuum zones.
• Single centered vacuum badge
The separate "REPAIR PATH / REPAIR DONE" centered badge was removed. The vacuum
badge already shows repair status ("LIQUIDITY VACUUM / REPAIR X%"), so the
second badge was redundant and could sit on top of it once repair completed. The
repair-progress fill inside the zone is unchanged.
------------------------
Visual Improvements
------------------------
• Higher-contrast event labels, centered badges and right-side tags.
• Eliminated event-label stacking, right-edge tag crowding, and the
badge-on-badge overlap of the two centered badges once repair completed.
• Cleaner right-side shelf with VAC HIGH and VAC LOW only.
------------------------
Interface & Usability
------------------------
• Panel layout and themes (Elite Dark, Slate, Clean Light) are unchanged; the
full metric stack (Vacuum State, Quality Score, Vacuum Type, Repair Progress,
Rejection Risk, Target Zone, Next Context) is preserved.
------------------------
Behavior Notes
------------------------
This update does not change any displacement-detection, vacuum, repair-tracking,
scoring or state logic. Only label text, label text-color and the on-chart
placement of event labels and right-side tags were adjusted. Interpretation of
all outputs is unchanged.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool. Market conditions such as
volatility, liquidity and timeframe differences may affect how vacuums, repairs
and scores 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.
Script open-source
Nello spirito di TradingView, l'autore di questo script lo ha reso open source, in modo che i trader possano esaminarne e verificarne la funzionalità. Complimenti all'autore! Sebbene sia possibile utilizzarlo gratuitamente, ricordiamo che la ripubblicazione del codice è soggetta al nostro Regolamento.
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
Declinazione di responsabilità
Le informazioni e le pubblicazioni non sono intese come, e non costituiscono, consulenza o raccomandazioni finanziarie, di investimento, di trading o di altro tipo fornite o approvate da TradingView. Per ulteriori informazioni, consultare i Termini di utilizzo.
Script open-source
Nello spirito di TradingView, l'autore di questo script lo ha reso open source, in modo che i trader possano esaminarne e verificarne la funzionalità. Complimenti all'autore! Sebbene sia possibile utilizzarlo gratuitamente, ricordiamo che la ripubblicazione del codice è soggetta al nostro Regolamento.
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
Declinazione di responsabilità
Le informazioni e le pubblicazioni non sono intese come, e non costituiscono, consulenza o raccomandazioni finanziarie, di investimento, di trading o di altro tipo fornite o approvate da TradingView. Per ulteriori informazioni, consultare i Termini di utilizzo.