Liquidity Vacuum Recovery Map [AGPro Series]Liquidity Vacuum Recovery Map
🧠 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.
Chỉ báo Pine Script®






















