OPEN-SOURCE SCRIPT
Updated Volume Climax Detector [AGPro Series]
Volume Climax Detector [AGPro Series]
Volume Climax Detector [AGPro Series] is an advanced volume analytics tool that identifies extreme institutional volume events using a three-filter VSA (Volume Spread Analysis) methodology. Rather than triggering on simple volume multiples, the script combines Volume Z-Score statistics, Spread analysis, and Close Location to isolate genuine climax bars — the kind of exhaustion moves Wyckoff and VSA traders look for at trend tops and bottoms.
🔹 OVERVIEW
Volume alone is a noisy signal. A "high volume bar" on one instrument is a quiet bar on another, and most volume-based indicators either miss real climaxes or fire on every uptick. This script takes a statistical approach: it measures how extreme each bar's volume is relative to its own recent history (Z-Score), confirms the bar structure makes sense (Spread and Close Location), and then classifies the event as a Buying Climax or Selling Climax using trend context — the Wyckoff way.
The result is a small number of high-conviction labels at exactly the places where large participants tend to exhaust themselves: panic buys at tops, panic sells at bottoms, and hidden absorption in between.
🔹 WHAT MAKES IT DIFFERENT
Most volume indicators apply a single threshold (e.g. volume > 2× average) and stop there. This script layers three independent VSA filters, each addressing a different failure mode:
• Volume Z-Score — adapts to the instrument's own volume distribution. A 3σ event on BTC is genuinely rare, regardless of session or timeframe.
• Spread filter — requires the bar's range to exceed its recent average. Eliminates the common false positive of a high-volume bar that barely moved (compression).
• Close Location — requires the close to sit in the upper or lower third of the bar. Separates conviction from indecision.
Beyond detection, two analytics layers set it apart from typical volume tools:
• Reversal Success Tracking — every climax is tracked forward for a configurable window, and the script records whether a meaningful counter-move actually materialised (measured in ATR). The panel shows a live Reversal Rate, so users get honest feedback on how well climaxes have worked on the current symbol and timeframe.
• Magnitude Scoring (1–10) — every climax receives a strength score derived from its Z-Score, making it easy to distinguish routine spikes from truly extreme events (marked with ★).
🔹 METHODOLOGY
1. Volume Statistics
The script computes a rolling mean and standard deviation of volume over a configurable lookback window (default 50 bars). The Z-Score tells how many standard deviations above the mean the current bar is. A reading of 3.0σ or higher (default threshold) corresponds to the top ~0.27% of bars — statistically rare, not just "above average."
2. Triple Filter Gate
A bar qualifies as a potential climax only when:
• Z-Score ≥ threshold (volume anomaly)
• Bar range ≥ spread multiplier × average range (wide spread)
• Close is in the upper 33% (strength) or lower 33% (weakness) of the bar range
3. Wyckoff Classification
• Buying Climax — qualifying bar during an established uptrend. Interpretation: buyers are exhausting themselves; potential topping action.
• Selling Climax — qualifying bar during an established downtrend. Interpretation: sellers are exhausting themselves; potential basing action.
• When no clear trend exists, classification falls back to close location plus bar direction so that sideways regimes still produce meaningful signals.
4. Confluence Grouping
When multiple same-direction climaxes occur close together in time or price, the script collapses them into a single label representing the strongest event in the cluster. This keeps charts readable without losing information — the panel still counts every individual climax.
5. Effort vs Result (optional)
A companion layer flags high-volume bars with unusually narrow spread — the classic VSA "No Demand" and "No Supply" conditions. These often signal hidden absorption ahead of a reversal and are shown as separate labels.
🔹 SIGNALS & ALERTS
Four built-in alert conditions:
• Buying Climax detected
• Selling Climax detected
• Extreme Climax (Z-Score above the extreme threshold, marked with ★)
• No Demand / No Supply divergence
Each alert payload includes the symbol, Z-Score, and magnitude score, ready for automation or review.
🔹 KEY INPUTS
• Volume Lookback (default 50) — rolling window for statistics.
• Z-Score Threshold (default 3.0σ) — minimum statistical extremity. Lower on intraday, higher for premium signals only.
• Extreme Threshold (default 4.0σ) — above this, climaxes are flagged with a ★.
• Spread and Close filters — each can be toggled independently for flexibility across asset classes.
• Trend EMA Length and Sensitivity — control how the script defines uptrend and downtrend, with an ATR-normalised slope check to avoid misclassifying sideways regimes.
• Reversal Window and Threshold — define what counts as a "successful" reversal for the panel statistic.
• Confluence controls — Time-first (default), Price-first, or Strict mode, plus bar and ATR tolerances.
• Climax Zones (optional, default off) — extends each climax bar's range forward as a reaction zone, similar to S/R.
🔹 HOW TO USE
• Start with defaults on any liquid instrument and timeframe. The script adapts to the local volume distribution automatically.
• On highly volatile intraday timeframes, consider raising the Z-Score Threshold to 3.5σ for fewer, cleaner signals. On slower timeframes, the default works well.
• Treat a ★ Extreme Climax as higher-conviction than a plain climax, and pay attention to the Magnitude Score for fine gradation.
• Use the Reversal Rate panel value as a feedback loop — if it is low on your chosen instrument and timeframe, either adjust thresholds or reconsider the setup.
• Combine with your own structural analysis (support/resistance, HTF trend, market structure) for confirmation. The script identifies the event, not the entry.
🔹 LIMITATIONS & TRANSPARENCY
• This is an indicator, not a strategy. It does not generate buy or sell orders and makes no assumption about position sizing or risk management.
• Climaxes are statistical events. They tend to mark inflection points, but no volume pattern resolves into a reversal every time. The built-in Reversal Rate panel value exists precisely to make this honest — users see the actual hit rate on their own chart.
• The script uses publicly available volume data from the chart's exchange. Volume quality varies by venue; results may differ on symbols with thin or unreliable volume reporting.
• Classification depends on trend context. In strongly sideways regimes, the fallback rules may label climaxes differently than a human analyst would; reviewing the Trend EMA and sensitivity inputs helps here.
• Labels are confirmed on bar close (no repaint). Panel counters and the Current Z-Score value update intrabar for live monitoring.
🔹 RISK DISCLOSURE
Trading involves substantial risk of loss. Past behaviour of any signal or statistic does not guarantee future performance. This script is a research and analysis tool — it is not investment advice, a recommendation, or a solicitation to trade. Users are responsible for their own decisions, risk management, and position sizing.
Volume Climax Detector [AGPro Series] is an advanced volume analytics tool that identifies extreme institutional volume events using a three-filter VSA (Volume Spread Analysis) methodology. Rather than triggering on simple volume multiples, the script combines Volume Z-Score statistics, Spread analysis, and Close Location to isolate genuine climax bars — the kind of exhaustion moves Wyckoff and VSA traders look for at trend tops and bottoms.
🔹 OVERVIEW
Volume alone is a noisy signal. A "high volume bar" on one instrument is a quiet bar on another, and most volume-based indicators either miss real climaxes or fire on every uptick. This script takes a statistical approach: it measures how extreme each bar's volume is relative to its own recent history (Z-Score), confirms the bar structure makes sense (Spread and Close Location), and then classifies the event as a Buying Climax or Selling Climax using trend context — the Wyckoff way.
The result is a small number of high-conviction labels at exactly the places where large participants tend to exhaust themselves: panic buys at tops, panic sells at bottoms, and hidden absorption in between.
🔹 WHAT MAKES IT DIFFERENT
Most volume indicators apply a single threshold (e.g. volume > 2× average) and stop there. This script layers three independent VSA filters, each addressing a different failure mode:
• Volume Z-Score — adapts to the instrument's own volume distribution. A 3σ event on BTC is genuinely rare, regardless of session or timeframe.
• Spread filter — requires the bar's range to exceed its recent average. Eliminates the common false positive of a high-volume bar that barely moved (compression).
• Close Location — requires the close to sit in the upper or lower third of the bar. Separates conviction from indecision.
Beyond detection, two analytics layers set it apart from typical volume tools:
• Reversal Success Tracking — every climax is tracked forward for a configurable window, and the script records whether a meaningful counter-move actually materialised (measured in ATR). The panel shows a live Reversal Rate, so users get honest feedback on how well climaxes have worked on the current symbol and timeframe.
• Magnitude Scoring (1–10) — every climax receives a strength score derived from its Z-Score, making it easy to distinguish routine spikes from truly extreme events (marked with ★).
🔹 METHODOLOGY
1. Volume Statistics
The script computes a rolling mean and standard deviation of volume over a configurable lookback window (default 50 bars). The Z-Score tells how many standard deviations above the mean the current bar is. A reading of 3.0σ or higher (default threshold) corresponds to the top ~0.27% of bars — statistically rare, not just "above average."
2. Triple Filter Gate
A bar qualifies as a potential climax only when:
• Z-Score ≥ threshold (volume anomaly)
• Bar range ≥ spread multiplier × average range (wide spread)
• Close is in the upper 33% (strength) or lower 33% (weakness) of the bar range
3. Wyckoff Classification
• Buying Climax — qualifying bar during an established uptrend. Interpretation: buyers are exhausting themselves; potential topping action.
• Selling Climax — qualifying bar during an established downtrend. Interpretation: sellers are exhausting themselves; potential basing action.
• When no clear trend exists, classification falls back to close location plus bar direction so that sideways regimes still produce meaningful signals.
4. Confluence Grouping
When multiple same-direction climaxes occur close together in time or price, the script collapses them into a single label representing the strongest event in the cluster. This keeps charts readable without losing information — the panel still counts every individual climax.
5. Effort vs Result (optional)
A companion layer flags high-volume bars with unusually narrow spread — the classic VSA "No Demand" and "No Supply" conditions. These often signal hidden absorption ahead of a reversal and are shown as separate labels.
🔹 SIGNALS & ALERTS
Four built-in alert conditions:
• Buying Climax detected
• Selling Climax detected
• Extreme Climax (Z-Score above the extreme threshold, marked with ★)
• No Demand / No Supply divergence
Each alert payload includes the symbol, Z-Score, and magnitude score, ready for automation or review.
🔹 KEY INPUTS
• Volume Lookback (default 50) — rolling window for statistics.
• Z-Score Threshold (default 3.0σ) — minimum statistical extremity. Lower on intraday, higher for premium signals only.
• Extreme Threshold (default 4.0σ) — above this, climaxes are flagged with a ★.
• Spread and Close filters — each can be toggled independently for flexibility across asset classes.
• Trend EMA Length and Sensitivity — control how the script defines uptrend and downtrend, with an ATR-normalised slope check to avoid misclassifying sideways regimes.
• Reversal Window and Threshold — define what counts as a "successful" reversal for the panel statistic.
• Confluence controls — Time-first (default), Price-first, or Strict mode, plus bar and ATR tolerances.
• Climax Zones (optional, default off) — extends each climax bar's range forward as a reaction zone, similar to S/R.
🔹 HOW TO USE
• Start with defaults on any liquid instrument and timeframe. The script adapts to the local volume distribution automatically.
• On highly volatile intraday timeframes, consider raising the Z-Score Threshold to 3.5σ for fewer, cleaner signals. On slower timeframes, the default works well.
• Treat a ★ Extreme Climax as higher-conviction than a plain climax, and pay attention to the Magnitude Score for fine gradation.
• Use the Reversal Rate panel value as a feedback loop — if it is low on your chosen instrument and timeframe, either adjust thresholds or reconsider the setup.
• Combine with your own structural analysis (support/resistance, HTF trend, market structure) for confirmation. The script identifies the event, not the entry.
🔹 LIMITATIONS & TRANSPARENCY
• This is an indicator, not a strategy. It does not generate buy or sell orders and makes no assumption about position sizing or risk management.
• Climaxes are statistical events. They tend to mark inflection points, but no volume pattern resolves into a reversal every time. The built-in Reversal Rate panel value exists precisely to make this honest — users see the actual hit rate on their own chart.
• The script uses publicly available volume data from the chart's exchange. Volume quality varies by venue; results may differ on symbols with thin or unreliable volume reporting.
• Classification depends on trend context. In strongly sideways regimes, the fallback rules may label climaxes differently than a human analyst would; reviewing the Trend EMA and sensitivity inputs helps here.
• Labels are confirmed on bar close (no repaint). Panel counters and the Current Z-Score value update intrabar for live monitoring.
🔹 RISK DISCLOSURE
Trading involves substantial risk of loss. Past behaviour of any signal or statistic does not guarantee future performance. This script is a research and analysis tool — it is not investment advice, a recommendation, or a solicitation to trade. Users are responsible for their own decisions, risk management, and position sizing.
Release Notes
UPDATE NOTES - V2.0This update focuses on turning Volume Climax Detector into a cleaner volume reaction decision engine.
The core purpose of the script remains unchanged.
It still detects important high-volume climax events, but this release improves how the event is evaluated after it appears 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
------------------------
* Added a 0-100 Event Score
The score now combines relative volume, volume Z-score, spread quality, close location, trend context, and post-event progress.
* Added post-climax state classification
The script now evaluates whether the climax is developing into Continuation, Exhaustion, Failed Event, Testing, Expired, or Confirming state.
* Added a clear next-action state
The panel now shows READY, MONITOR, WAIT, or INVALIDATED so the script works more like a decision-support tool without leaving old events in an active-risk state.
* Added failure-risk logic
The update introduces a 0-100 failure-risk reading based on range position, time decay, failed follow-through, and invalidation behavior.
* Rebuilt the panel around the V2 roadmap
The panel now uses the required rows: Climax Side, Volume Multiple, Follow-Through, Failure Risk, and Action.
* Added Publication Clean defaults
The default visual preset is now tuned for a cleaner public screenshot with fewer labels, quieter guide objects, and stronger event filtering.
* Improved active-window handling
The panel now separates a live follow-through window from an older closed event, avoiding stale INVALIDATED readings after the event window has already passed.
* Restored historical climax reaction zones
The update preserves the popular public version's extended zone-map look while keeping the new V2 follow-through logic in the panel.
------------------------
Visual Improvements
------------------------
* Added centered follow-through boxes around qualified climax events.
* Added optional failure rails to show where the event context is weakening.
* Added optional follow-through guide lines for cleaner event tracking.
* Improved label positioning so event labels appear above or below candles instead of getting buried inside price action.
* Simplified default box text so the chart keeps the original premium Volume Climax identity instead of becoming a diagnostic board.
* Preserved the familiar short chart badge style from the popular public version while moving deeper 0-100 decision data into the panel.
* Made default follow-through boxes shorter and more transparent for a cleaner first impression across intraday and higher-timeframe charts.
* Removed default CLOSED box text while keeping the historical reaction zones visible, so the chart stays clean without losing the original zone identity.
* Reduced generic volume-signal behavior and kept the visual focus on the active climax reaction.
------------------------
Interface & Usability
------------------------
* Added adjustable panel location, panel theme, and panel font size.
* Added adjustable label font size with Normal as the default.
* Added a Show Info Panel setting, enabled by default.
* Added object limits and cooldown controls to keep the chart readable and responsive.
* Kept the first panel row as a single merged blue AGPro header row.
------------------------
Behavior Notes
------------------------
This update does not change the public identity of Volume Climax Detector.
The script remains focused on volume climax events, but the new engine is designed to answer what happened after the climax:
* Did the event follow through?
* Did it exhaust?
* Did it fail?
* Is the context still worth monitoring?
The goal is to improve clarity and usability, not to introduce predictive behavior.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Volume behavior can vary across symbols, sessions, liquidity conditions, and timeframes.
Low-liquidity markets, noisy intraday conditions, and extreme volatility can reduce signal quality.
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.
Release Notes
UPDATE NOTES - v2.1This update focuses on premium presentation and readability.
The core purpose of the script remains unchanged. This release improves how the
existing climax reaction zones are labeled on the chart, on both light and dark
backgrounds.
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
------------------------
- Premium zone badge instead of in-box text
The climax reaction state (climax window, testing, continuation, exhaustion,
failed) is now shown on a solid, color-filled badge placed at the right edge
of each reaction zone and vertically centered. This keeps the state label
clear of the candles and consistently readable instead of floating text inside
the zone.
- Theme-aware badge text
The badge text color adapts to its own background so the state reads cleanly on
light and dark charts alike.
------------------------
Visual Improvements
------------------------
- State badges sit at the right edge of each zone, away from the candles.
- Contrast-safe badge text on both light and dark themes.
- Reduced visual clutter inside the reaction zones for a cleaner first glance.
- Refined visual hierarchy so the event labels, reaction zones, and state badges
read clearly together.
------------------------
Interface & Usability
------------------------
- Cleaner, more readable reaction-zone labeling.
- Consistent premium styling between the event labels and the state badges.
- Adjusted default visual presentation for a more balanced, premium appearance.
- Enhanced overall user experience without changing core logic.
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
The climax detection, the event scoring, the follow-through evaluation
(continuation / exhaustion / failed / expired), the failure-risk reading, and
the decision panel all behave exactly as before.
Users should interpret outputs the same way as before, but with a cleaner and
more readable presentation.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, and timeframe differences may
affect how climax events and their follow-through 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.
Open-source script
In true TradingView spirit, the creator of this script has made it open-source, so that traders can review and verify its functionality. Kudos to the author! While you can use it for free, remember that republishing the code is subject to our House Rules.
Public-free and invite-only TradingView Pine Script tools for market analysis, risk planning, liquidity and execution review.
Script library & access: aligurtuna.com/agprolabs-pine-scriptleri/
Telegram: t.me/agprolabs
Script library & access: aligurtuna.com/agprolabs-pine-scriptleri/
Telegram: t.me/agprolabs
Disclaimer
The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by TradingView. Read more in the Terms of Use.
Open-source script
In true TradingView spirit, the creator of this script has made it open-source, so that traders can review and verify its functionality. Kudos to the author! While you can use it for free, remember that republishing the code is subject to our House Rules.
Public-free and invite-only TradingView Pine Script tools for market analysis, risk planning, liquidity and execution review.
Script library & access: aligurtuna.com/agprolabs-pine-scriptleri/
Telegram: t.me/agprolabs
Script library & access: aligurtuna.com/agprolabs-pine-scriptleri/
Telegram: t.me/agprolabs
Disclaimer
The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by TradingView. Read more in the Terms of Use.