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.
Indicatore Pine Script®






















