Volume Climax Detector [AGPro Series]Volume Climax Detector
Volume Climax Detector 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.
مؤشر Pine Script®
