Volume Spike Aftershock Planner [AGPro Series]Volume Spike Aftershock Planner
🧠 Core Idea
After a volume spike, is price actually defending the impulse, absorbing it, or losing control completely?
📌 Overview / What it does
Volume Spike Aftershock Planner is designed to evaluate what happens after an abnormal volume expansion candle appears on the chart. Instead of stopping at the spike itself, the script studies the post-impulse behavior and organizes that structure into a readable decision-support framework.
The script maps a spike anchor, an active aftershock band, a failure boundary, and a target-room reference. It also produces contextual labels, right-side price tags, and a compact information panel that summarizes the current aftershock condition with a rule-based score.
This script does not attempt to predict the next candle, automate entries, or generate guaranteed continuation signals. It is an analytical visualization tool that helps users judge whether the spike is still being respected, partially absorbed, or fully invalidated.
🎯 Purpose & Design Philosophy
This script was built to solve a common gap in volume analysis.
Most traders can see when volume suddenly expands. The harder question is what to do with that information after the impulse bar closes. A large volume candle can lead to continuation, rejection, absorption, or complete failure, and those outcomes do not deserve the same interpretation.
This tool helps traders who want a more structured way to read post-spike behavior. It supports a patient, evidence-based mindset by focusing on participation quality, impulse defense, failure thresholds, and available room rather than hype or prediction.
⚡ Why This Script Is Different
Most volume tools focus on spike detection, raw histogram expansion, or one-bar climax alerts.
This script does NOT stop at identifying unusual participation.
Instead, it tracks the aftershock environment that forms after the spike, measures whether price is holding the impulse anchor, maps when the move is being absorbed, and highlights when the context has either matured or failed. The result is not just a volume event marker, but a structured framework for interpreting what the spike still means.
⚙️ Methodology
1. Context Detection
The script scans for abnormal volume participation and range expansion relative to recent behavior. It also reviews body quality so that weak, indecisive candles are filtered more carefully.
2. Reference Mapping
Once a valid spike is confirmed, the script establishes a spike anchor and builds an aftershock band around that reference. It also defines a failure boundary and a room projection.
3. Reaction Evaluation
Price is then evaluated relative to the anchor and surrounding rails. The script checks whether the impulse is being defended, fading back through the anchor, or failing beyond the allowed structure.
4. Visual Output
The final output includes the aftershock band, anchor reference, room line, failure line, event labels, right-side tags, optional bar coloring, and a dashboard panel that summarizes the current state.
🗺️ How to Read the Chart
Zones:
The aftershock band represents the active post-spike area where the market is being evaluated. It is the main structure zone for interpreting whether the impulse still matters.
Labels:
Labels mark important contextual events such as bull spike, bear spike, holding behavior, absorbed behavior, target review, and failure.
Colors:
Teal highlights constructive bullish behavior or defended impulse structure.
Pink highlights bearish structure, invalidation, or failed context.
Gold highlights review areas such as absorption or target-room interaction.
Indigo highlights the spike anchor reference.
Panel:
The panel summarizes the spike state, the Aftershock Score, participation quality, available room, and the current action state.
🚦 Signals & States
• Bull Spike → A bullish high-participation impulse anchor has been detected.
• Bear Spike → A bearish high-participation impulse anchor has been detected.
• Holding → Price is still defending the impulse structure after the spike.
• Aftershock Ready → The post-spike condition is strong enough to deserve active attention.
• Absorbed → Price has moved back through the anchor and the impulse is losing control.
• Target Review → The projected first room objective has been reached and context should be reassessed.
• Failed → The active aftershock structure has broken down beyond the allowed limit.
• Wait Spike → No valid active spike context is currently available.
• Expired → The spike is too old to remain actionable within the current framework.
🔔 Alerts Logic
Alerts can trigger when a new bullish or bearish spike is detected, when price begins to hold the impulse, when the aftershock condition becomes ready, when the move becomes absorbed, when target room is reached, or when the context fails.
These alerts are attention markers only. They highlight a structural event inside the script logic. They are not trade instructions, automated entries, or guarantees of follow-through.
🧩 Confluence Logic
The context becomes stronger when multiple conditions align at the same time.
For example, a high relative-volume spike with strong candle expansion, defended anchor structure, stable participation decay, and clear room beyond the band creates a much stronger environment than a spike that immediately collapses back through its reference level.
This confluence logic is what separates a meaningful aftershock structure from a noisy one-bar event.
📊 When to Use
• Markets with reliable volume behavior
• Crypto pairs with clean participation swings
• Stocks and indices with readable impulse candles
• Breakout or breakdown follow-through evaluation
• Continuation review after a strong reaction candle
• 1H, 4H, and 1D chart studies where impulse quality matters
⚠️ When NOT to Use
• Illiquid symbols with distorted or unreliable volume
• Extremely noisy low-range environments
• Symbols where volume feed quality is poor
• Isolated one-bar anomalies with no structural follow-through
• Extreme volatility conditions where impulse rails become unstable too quickly
🎛️ Key Inputs
• Relative Volume Length → Controls the participation baseline used for spike comparison.
• Minimum Relative Volume → Controls how large the volume expansion must be before the candle qualifies as a spike.
• Minimum Range Ratio → Controls how much price expansion is required.
• Minimum Body Ratio → Filters out weak spike candles with poor body commitment.
• Aftershock Band ATR → Controls the depth of the active aftershock zone.
• Failure Buffer → Controls how far price can move before the spike idea is considered broken.
• Minimum Ready Score → Controls how strict the script is before showing stronger actionable states.
• Visual Settings → Control labels, panel location, theme, font size, and optional chart styling.
🖥️ Interface & Visual Design
The visual design is built around clarity at first glance.
The panel gives a fast structural summary without forcing the user to inspect every line manually. The chart layer uses premium contrast and a clear hierarchy so the aftershock band, anchor, failure boundary, and room references remain readable without overwhelming the candles.
The goal is not decoration. The goal is clean interpretation under live market conditions.
🧪 Practical Usage Workflow
1. Read the panel to understand the current spike state and score.
2. Check whether a valid spike anchor and aftershock band are active.
3. Evaluate whether price is holding, absorbed, or failing relative to the anchor.
4. Review available room and decide whether the current context is mature, early, or already extended.
5. Use labels and tags as structured context markers, not as automatic commands.
🔍 Interpretation Guidelines
Treat the script as a structured reading framework.
A stronger score suggests that the spike had better participation, cleaner range expansion, and more stable post-spike structure. A weaker score suggests that the move may be losing informational value.
An absorbed state does not mean reversal is guaranteed. It means the original impulse is no longer being defended as cleanly as before.
A target-review state does not mean the move must stop. It means the first projected room objective has already been reached and the user should reassess the context rather than assuming endless continuation.
🚫 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 is not a broker integration.
It does not place orders.
It does not guarantee continuation, reversal, or profitability.
⚠️ Limitations & Transparency
This script is rule-based and depends on the quality of the underlying market data.
Timeframe changes can materially alter how spikes, bands, and room projections appear. High-volatility environments can also reduce the stability of post-spike structures. In thin or distorted markets, volume expansion may look meaningful while carrying very little analytical value.
The script should always be interpreted in broader market context rather than in isolation.
🧠 Market Context Notes
Volume spikes are often strongest when they appear at meaningful structure transitions, liquidity shifts, or expansion points where the market is forced to reveal intent.
That said, not every spike represents sustainable conviction. Some are exhaustion bursts, some are absorption events, and some are temporary reactions inside a larger opposing structure. The aftershock behavior is often more important than the spike itself.
🧾 Use Case Examples
Example 1:
Price breaks above a local range with a large bullish volume surge. The script marks a bull spike, price holds above the anchor, and the panel shifts into a stronger aftershock state. This suggests the impulse still deserves attention.
Example 2:
Price prints a large bearish impulse, but then quickly moves back through the anchor. The script shifts into an absorbed condition, signaling that the original downside impulse is losing control.
Example 3:
A high-volume move expands sharply, then reaches the target-room area. The script marks target review, reminding the user to reassess the move rather than assuming continuation is still efficient.
🧱 System Philosophy
AGPro Series tools are designed as decision-support frameworks, not signal vending machines.
The philosophy is simple: map structure clearly, make states readable, reduce noise, and help the user think better around live price behavior.
🔐 Non-Promise Statement
This script does not promise certainty.
It does not promise that a volume spike will continue, reverse, hold, or fail in any predetermined way. It simply organizes the available structure so the user can evaluate the situation with more clarity.
📉 Risk Disclosure
Trading and investing involve risk.
Market conditions can change quickly, and any analytical tool can produce outputs that become invalid under new volatility, liquidity, or structural conditions. Users remain fully responsible for their own decisions, risk management, and execution.
This script is provided for educational and analytical purposes only. It is not financial advice.
📚 Educational Note
This tool is most useful when treated as a market-reading assistant.
The best results usually come from combining it with broader structure analysis, liquidity awareness, and disciplined risk management rather than using it as a standalone trigger system.
Indicator
Volume Trap Reversal Planner [AGPro Series]Volume Trap Reversal Planner
🧠 Core Idea
Did a volume spike trap one side of the market and reverse with enough confirmation to deserve attention?
📌 Overview / What it does
Volume Trap Reversal Planner is a chart-first reversal planning tool built around high-volume trap behavior.
Instead of treating every volume spike or wick sweep as a reversal signal, the script checks whether price expands through a recent reference, prints unusual relative volume, fails to hold the move, recovers back through the reference, and then confirms with a follow-through candle.
The output includes volume trap pockets, reclaim rails, risk edges, target-room bands, compact event labels, alerts, and a clean AGPro decision panel. It does not predict price, automate trades, or claim that every trap will reverse.
🎯 Purpose & Design Philosophy
The script was built for traders who want to separate meaningful high-volume trap events from ordinary noisy spikes.
Many reversal tools focus only on a wick, a candle pattern, or a support/resistance touch. This planner focuses on the decision layer after a volume trap forms: whether the trap is confirmed, where the risk edge sits, where target-room review begins, and what the next action state should be.
The design supports a structured review mindset: identify the trap, wait for confirmation, monitor the risk edge, and read the context through a 0-100 score instead of reacting to a single candle.
⚡ Why This Script Is Different
Most tools focus on volume spikes as standalone events or classify every sweep as a reversal attempt.
This script does NOT operate as a generic stop-run scanner, a broad liquidity sweep map, or a simple volume climax labeler.
Instead, it combines relative volume, wick sweep behavior, close recovery, confirmation candle quality, follow-through, risk edge placement, and target-room context into one planner-style reversal model.
⚙️ Methodology
1. Context Detection
The script builds a rolling high/low reference range and watches for unusual volume expansion near those references.
2. Trap Mapping
When price sweeps beyond the reference with elevated volume and recovers back inside, the script maps the volume trap pocket.
3. Reversal Evaluation
The planner evaluates wick quality, recovery strength, confirmation candle structure, follow-through distance, and the active risk edge.
4. Visual Output
The result is translated into a 0-100 reversal score, a next-action state, on-chart labels, risk/target guides, and a compact AGPro panel.
🗺️ How to Read the Chart
Zones = volume trap pockets created by a high-volume sweep and recovery.
Labels = trap watch, reversal ready, trap failed, or target review states.
Colors = bull-side reversals use teal, bear-side reversals use pink, watch states use amber, and review/target context uses indigo.
Panel = current trap side, volume spike multiple, reversal score, risk edge, and next action.
🚦 Signals & States
• VOL TRAP WATCH → a high-volume trap candidate formed and needs confirmation.
• REVERSAL READY → the trap received confirmation and reached the required score.
• TRAP FAILED → price closed beyond the risk edge and the active trap context weakened.
• TARGET REVIEW → price reached the target-room review band for the active plan.
🔔 Alerts Logic
Alerts trigger when a volume trap watch appears, when reversal confirmation reaches the required score, when the active trap fails through the risk edge, or when price reaches the target-room review band.
Alerts are attention markers only. They are not trade instructions.
🧩 Confluence Logic
The context becomes stronger when volume spike quality, wick sweep behavior, close recovery, confirmation candle structure, and follow-through align in the same direction.
The score is intentionally multi-factor so a single dramatic candle does not dominate the interpretation.
📊 When to Use
• 4H charts for the cleanest public visual balance
• Markets with reliable volume data
• High-volume reactions around recent highs or lows
• Reversal review after failed breakout or failed breakdown attempts
• Active intraday or swing charts where trap behavior is visible
⚠️ When NOT to Use
• Very low-liquidity symbols
• Markets with unreliable or missing volume data
• Extremely noisy ranges where every candle sweeps both sides
• News-driven volatility where candle structure can distort normal context
🎛️ Key Inputs
• Trap Reference Lookback → controls the rolling high/low range used for trap detection.
• Volume Spike RVOL → adjusts how much relative volume is required.
• Sensitivity → changes sweep, wick, and volume selectivity.
• Confirmation Mode → controls how strict the confirmation candle must be.
• Risk / Target Logic → controls risk edge buffers and target-room bands.
• Visual Settings → control zones, rails, labels, panel location, theme, and font sizes.
🖥️ Interface & Visual Design
The interface is built around a clean AGPro panel and chart-first visual hierarchy.
Trap pockets show where the volume trap occurred. Labels identify the current state without overcrowding the chart. Risk and target guides make the output easier to interpret as a planning tool rather than a raw signal board.
🧪 Practical Usage Workflow
1. Read the panel and check the active trap side.
2. Inspect the volume trap pocket and reclaim rail.
3. Wait for reversal confirmation instead of reacting to the spike alone.
4. Compare the current state with the risk edge and target-room band.
5. Interpret the score within broader market context.
🔍 Interpretation Guidelines
A high score means the trap structure, volume spike, recovery, and confirmation are aligned more cleanly.
A watch state means the event is still developing.
A failed state means the active trap context has weakened or invalidated according to the script's rules.
Use the output as structured context, not as a standalone decision.
🚫 What This Script Is NOT
• Not a prediction engine
• Not financial advice
• Not an auto-trading system
• Not a guaranteed reversal signal
• Not a generic liquidity sweep scanner
⚠️ Limitations & Transparency
Volume quality varies by symbol, exchange, and asset class.
Different timeframes may produce different trap pockets and confirmation states.
High volatility can make traps appear and fail quickly.
The script is rule-based and cannot know news, order flow intent, execution quality, or broader discretionary context.
🧠 Market Context Notes
Volume traps often matter most when they occur at obvious participation points, such as recent highs, recent lows, failed breakouts, or failed breakdowns.
The strongest use case is not the spike itself. The strongest use case is the sequence after the spike: recovery, confirmation, risk edge, and follow-through.
🧾 Use Case Examples
When price sweeps below a recent low on elevated volume, closes back above the reference, and confirms upward within the allowed window, the planner can mark a bullish reversal context.
When price sweeps above a recent high on elevated volume, fails to hold, and confirms downward, the planner can mark a bearish reversal context.
🧱 System Philosophy
Volume Trap Reversal Planner belongs to the AGPro planner-style workflow: detect the event, score the evidence, define the risk edge, map the review zone, and guide the next chart-reading step.
🔐 Non-Promise Statement
No trap, score, label, or alert can guarantee a reversal.
No script can provide certainty.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions, risk management, and market interpretation.
This script is for educational and analytical purposes only and does not provide financial advice.
📚 Educational Note
Use the script to study how high-volume failed moves behave after sweeping recent references. The most useful insights come from comparing confirmed traps, failed traps, and ignored spikes across different markets and timeframes.
Indicator
Institutional Candle Detector [AGPro Series]🕯️ Institutional Candle Detector
Every trader has stared at a massive candle and asked the same question: "Was that the start of a move, the end of one, or just noise?" Most indicators stop at detection — they paint the candle, drop a label, and walk away. This one keeps watching.
Institutional Candle Detector uses a dual-track engine. The body-driven track flags high-conviction candles where ATR-normalized body size and relative volume both expand together, then classifies each event by body/wick geometry. The independent absorption track captures a different signature entirely — low-body candles on extreme volume, the classic aggression-absorbed footprint that body-only detectors miss. Every detected event is then re-evaluated over the following bars to produce a measurable outcome scorecard.
🔹 OVERVIEW
The script scans each bar for two separate, mutually-exclusive institutional signatures:
• Body-driven events. Body must exceed a multiple of ATR AND volume must exceed a multiple of its rolling average. Classified by geometry into Continuation, Reversal or Exhaustion.
• Absorption events. Volume extremely elevated BUT body contained — the market paid for a big move and did not get one. Price was absorbed.
Every detected candle is then given a reaction zone projected forward, and its outcome is automatically tagged after the configured look-forward window — Follow-Through (FT), Reverse (RV) or Consolidation (CN). The panel accumulates aggregate statistics across the loaded chart so the trader can see which candle type actually works on their instrument and timeframe.
🔸 UNIQUE EDGE
What separates this tool from generic "big candle" or "volume spike" indicators:
• Dual-track detection. A single filter cannot capture both explosive moves and absorption. This script runs two engines in parallel with independent thresholds.
• Four-class geometric taxonomy, each backed by a distinct detection path. Continuation and Reversal fire from the body-driven track with different geometry. Exhaustion catches the mid-profile edge cases. Absorption runs entirely off its own volume-first track.
• Automatic after-behavior tracking. Each event is re-examined after N bars and tagged with an outcome code. This is the part most scripts omit — and it's where edge lives.
• Aggregate statistics panel. Follow-through rate, reverse rate, consolidation rate, and per-class counts are computed continuously. The panel tells you whether institutional candles on this asset actually extend, reverse, or fade.
• Forward-projected zones, colored by class. Body-driven bull/bear events use state colors. Absorption uses an indigo accent so the rarer signature is instantly recognizable. Reversal zones use the contrarian color to emphasize the expected directional flip.
🔹 METHODOLOGY
Body-Driven Track (produces CONT, REV, EXH)
– Body is measured as absolute (close − open) and required to exceed Body × ATR multiple.
– Volume is required to exceed a configurable multiple of its SMA average.
– An optional wick filter rejects candles where total wick exceeds the body beyond a given ratio, removing wide-range noise that looks institutional but is not.
– Continuation: body% ≥ configured threshold (clean directional close).
– Reversal: opposing wick% ≥ configured threshold (sharp rejection after initial push).
– Exhaustion: passes the dual-gate but falls into neither clean category — mid profile, often late in a move.
Absorption Track (produces ABS)
– Volume must exceed an independently configurable multiple (higher than body-driven default).
– Body must be small — below a max Body × ATR and below a max Body / Range.
– When absorption fires, it takes precedence over body-driven classification.
After-Behavior Layer
– After lookFwd bars, the script compares the extreme price move in each direction against the original body size.
– If same-direction extension ≥ ftPct × body → Follow-Through (FT).
– If opposite-direction retrace ≥ revPct × body → Reverse (RV).
– Otherwise → Consolidation (CN).
Aggregate counters accumulate across the loaded chart, producing a running scorecard visible in the panel.
🔸 SIGNALS, STATES & MARKERS
On-chart signals
• Institutional body recolored by class — bull/bear direction for CONT and EXH; contrarian color for REV; accent color for ABS.
• Directional triangle marker above/below the bar.
• Classification label: INST-Bull 3.2x CONT or INST-Bear 5.4xV ABS format, ASCII only. Labels offset from the candle to stay readable on dense charts.
• Reaction zone box projected forward from the candle's high-low range, color-coded by class.
• Outcome marker (FT / RV / CN) plotted lookFwd bars after the event.
Alerts available
• Institutional Continuation
• Institutional Reversal
• Institutional Absorption
• Institutional Exhaustion
All four alerts fire on confirmed bars only.
🔹 KEY INPUTS
Detection Core (body-driven track)
– ATR Length (default 14)
– Volume Average Length (default 20)
– Min Body × ATR (default 2.0)
– Min Volume Multiple (default 2.5)
– Wick filter toggle and max Wick/Body ratio (default 2.5)
Absorption Track
– Enable Absorption Detection
– Absorption Min Volume Multiple (default 4.0)
– Absorption Max Body × ATR (default 1.5)
– Absorption Max Body / Range (default 0.40)
Classification
– Continuation body% threshold (default 0.60)
– Reversal opposing-wick% threshold (default 0.40)
After-Behavior
– Look-forward bars (default 5)
– Follow-through threshold as fraction of body (default 0.50)
– Reverse threshold as fraction of body (default 0.60)
Visuals
– Show/hide zones, zone projection length, opacity, max active zones
– Label size (default Small; increase if labels feel too compact)
– Institutional border width
– Outcome marker toggle
Panel
– 8-position panel placement
– Dark / Light theme
– Font size (default Normal)
– Recent events mini-list toggle
🔸 HOW TO USE
1. Start with defaults on a liquid asset. 4H is a strong baseline; 1H for active traders; Daily for swing context. On Daily, consider lowering Min Body × ATR to 1.5 if events are too rare.
2. Watch the panel accumulate events over two to four weeks on your instrument. The follow-through rate tells you whether institutional candles on this chart tend to extend or fade.
3. Trade-context usage:
– Continuation with a high historical follow-through rate on this asset → trend trades in candle direction after pullback into the zone.
– Reversal with a high historical reverse rate → fade setups at key levels.
– Absorption → aggressive flow was met by an equal or greater defender; often precedes a reversal or compression phase.
– Exhaustion → proceed with caution; frequently a late-move signature where the trend is losing clean structure.
4. Reaction zones act as provisional supply/demand. A retest of a zone with another institutional event near it is a confluence worth noting.
5. Tune thresholds per asset. High-liquidity instruments may need Body × ATR of 2.5+ to keep events selective; low-liquidity pairs can go down to 1.5. Absorption volume multiple can also be adjusted upward on already-volatile instruments.
🔹 LIMITATIONS & TRANSPARENCY
• This is an analytical indicator, not a strategy. No entry, exit, or stop logic is defined and no performance claims are made.
• Aggregate statistics are computed over the loaded chart window and will shift as more bars load or as timeframes change.
• Volume quality depends on the data feed; exchange-reported volume differs across sources for the same asset.
• Follow-through evaluation uses a fixed look-forward window; real trade management will differ.
• All results are historical and descriptive. Past behavior of any candle class does not guarantee future behavior.
🔸 RISK DISCLOSURE
Trading carries substantial risk. This tool is provided for analytical and educational purposes. Do your own research. Use position sizing and risk management appropriate to your account. Nothing in this script constitutes financial advice. Indicator
Volume Defense Zones [MarkitTick]💡 The Volume Defense Zones is a professional-grade liquidity analysis engine designed to identify institutional interest by isolating ultra-high volume transactions and mapping them as dynamic support and resistance zones. Unlike standard volume indicators that merely plot vertical bars, this script utilizes a sophisticated heatmap engine and a multi-timeframe (MTF) overlay to provide a three-dimensional view of market participation. By calculating the Volume Weighted Average Price (VWAP) specifically for high-intensity bars, the indicator creates "Defense Zones"—price levels where large-scale players have historically committed significant capital.
● ✨ Originality and Utility
This indicator distinguishes itself from the vast library of open-source tools through its unique "Search Depth" logic and automated zone merging capabilities. While many scripts identify volume spikes, they often clutter the chart with overlapping lines that lose relevance over time. This system solves that problem by:
• Dynamic Zone Consolidation
The script includes a proprietary merge threshold algorithm. If two high-volume defense levels are within a user-defined percentage of each other, the script automatically merges them into a single "Defense Box." This reflects the reality of market "zones" rather than surgical price points.
• Multi-Timeframe Institutional Benchmarking
By integrating a built-in MTF overlay, traders can visualize 4-hour or Daily volume defense zones while trading on a 5-minute chart. This ensures that the user is always aware of the "Big Picture" liquidity levels that are likely to hold during intraday volatility.
• Historical Ghosting and Breakout Analysis
The script tracks whether a zone is "active" or "broken." When price breaches a defense level, the zone doesn't simply disappear; it transforms into a "Ghost Zone" (dotted line), allowing traders to analyze S/R flips and historical retests of previously defended levels.
● 🔬 Methodology and Concepts
The core logic of the Volume Defense Zones is rooted in the identification of "Abnormal Volume" relative to a historical lookback period.
• Peak Volume Identification
The script maintains a rolling window of volume data defined by the "Comparison Length" input. A bar is classified as "Ultra High Volume" only if its volume exceeds the maximum volume recorded in that lookback window. This ensures that the signals adapt to changing market regimes (e.g., high-volatility sessions vs. low-volume holidays).
• The Defense Calculation
For every identified volume peak, the script calculates a localized VWAP using the internal formula:
Accumulated (Volume * Bar Body Center) / Total Volume.
This price level represents the "Average Cost Basis" of the participants during that specific high-intensity event. If the price remains above this VWAP, the level is treated as a Bullish Defense (Support). If price stays below it, it is a Bearish Defense (Resistance).
• Multi-Timeframe (MTF) Security
Using the request.security function with barmerge.lookahead_on (and appropriate offsets to prevent repainting), the script fetches high-volume levels from higher timeframes. This provides a top-down liquidity map that identifies where large institutions are "defending" their positions.
● 🎨 Visual Guide
The visual output is divided into three primary categories to ensure maximum clarity and actionable data visualization:
• The Volume Heatmap (Bottom Pane)
Instead of standard green and red bars, this script uses a professional 5-color heatmap gradient:
- Deep Blue (HM_C0): Low interest / baseline volume.
- Teal/Cyan (HM_C1/HM_C2): Rising interest.
- Gold (HM_C3): High participation.
- Bright Red (HM_C4): Ultra-High Volume.
These bars are framed with thicker borders when a new peak is detected, making the "Ultra Vol" events immediately visible.
• Defense Zones and Labels
- Green Boxes (ZONE_BULL_COL): Represent active bullish defense zones where buyers are currently in control of the high-volume level.
- Red Boxes (ZONE_BEAR_COL): Represent active bearish defense zones where sellers are successfully defending the level.
- Blue/Neutral Boxes (ZONE_INSIDE_COL): Represent zones where the price is currently trading inside the defense range, indicating a period of consolidation or "battle."
- Dotted Lines/Boxes: These are "Broken" or "Ghost" zones. They indicate levels that were previously significant but have been breached.
• Trend Climax Indicators
The script plots specific triangles on the volume bars:
- Green Up Triangle (▲): Bullish Climax. Occurs when price is trending down but a high-volume reversal is detected above the VWAP.
- Red Down Triangle (▼): Bearish Climax. Occurs when price is trending up but a high-volume rejection is detected below the VWAP.
• Professional Dashboard
A clean table in the top-right corner displays real-time statistics, including Total Volume, Max Volume, Average Volume, and the total count of analyzed bars.
● 📖 How to Use
Identifying Institutional Support: Look for thick green boxes formed during "Ultra High Vol" events. These are areas where price is likely to bounce upon a retest.
Trading the Breakout: When a red resistance zone is breached and turns into a dotted "Ghost" zone, wait for a retest of that level. If price holds above it, the old resistance has become new support.
Filtering with MTF: Only take long trades when the price is above the Purple MTF lines, which represent the higher-timeframe institutional defense levels.
Exhaustion Signals: Use the Climax Triangles (▲/▼) to identify potential trend reversals. A red triangle at the end of a long uptrend often signals that "smart money" is distributing their positions.
● ⚙️ Inputs and Settings
• Volume Settings
- Time Resolution: Allows you to change the granularity of the volume analysis.
- Comparison Length: Defines the lookback period (default 20) for determining what constitutes a "Peak" volume bar.
• Visual & Analysis
- Search Depth (Levels): Controls how many historical S/R zones are displayed on the chart. Increasing this provides more historical context but may clutter the view.
- Merge Threshold (%): A critical setting that defines how close two price levels must be to be grouped into a single zone.
- Show All Data Labels: Toggles the display of exact volume figures above the bars.
• Multi-Timeframe Overlay
- HTF Timeframe: Set the higher timeframe (e.g., 240 for 4-hour) to see macro defense zones.
- Max HTF Zones: Limits the number of MTF lines drawn to keep the chart clean.
● 🔍 Deconstruction of the Underlying Scientific and Academic Framework
The indicator is constructed upon the principles of **Auction Market Theory (AMT)** and **Volume Spread Analysis (VSA)**.
• Auction Market Theory
The fundamental premise is that the market is an ongoing auction where the purpose of price is to find the area where the most volume can be transacted. The "Defense Zones" calculated by this script represent "High Volume Nodes" (HVN). Scientifically, these are levels of high price acceptance. When price moves away from these zones and returns, the script tests whether the "Value" has shifted or if the previous participants are still willing to transact at that level.
• Statistical Outlier Theory
The "Ultra High Volume" detection utilizes a non-parametric approach to identify outliers. By comparing the current volume to the rolling maximum of the previous $N$ periods, the script effectively identifies events that fall outside the standard distribution of market activity. This is mathematically equivalent to identifying "Z-score" spikes in volume, signifying a significant shift in market sentiment or the injection of institutional liquidity.
• Volume Weighted Cost Basis (VWCB)
The use of VWAP within the defense zones is based on the academic concept of the "Volume Weighted Cost Basis." In institutional finance, the execution quality of a large trade is measured against the VWAP. Therefore, these levels act as psychological and financial "anchors" for large participants who need to protect their average entry price to maintain a profitable position.
⚠️ Disclaimer
All provided scripts and indicators are strictly for educational exploration and must not be interpreted as financial advice or a recommendation to execute trades. I expressly disclaim all liability for any financial losses or damages that may result, directly or indirectly, from the reliance on or application of these tools. Market participation carries inherent risk where past performance never guarantees future returns, leaving all investment decisions and due diligence solely at your own discretion. Indicator
Indicator
Indicator
Indicator
Indicator
