ATR Exceedance Probability Model [LuxAlgo]The Volatility Exceedance Probability Model (VEPM) indicator is a comprehensive statistical tool designed to quantify the significance of volatility spikes, determine the likelihood of trend continuation, and categorize market environments into specific regimes.
🔶 USAGE
The indicator provides a multi-layered view of volatility, allowing traders to distinguish between standard market noise and statistically significant "exceedance" events.
🔹 Oscillator Interpretation
The main oscillator plots the current exceedance frequency (the rate at which price or range breaches ATR-based thresholds) against a long-term baseline.
Bullish/Significant Glow: When the Z-Score of the frequency exceeds the sensitivity threshold, the oscillator glows green, indicating a high-probability volatility expansion.
Bearish/Normal Glow: When the frequency falls below the baseline, the oscillator shifts toward red, signaling a contraction in volatility.
Frequency Delta: The area between the current frequency and baseline frequency is filled to highlight the momentum of volatility expansion or exhaustion.
🔹 Chart Visuals & Regimes
The script overlays information directly on the price action to provide context:
ATR Bands: Dynamic bands based on the Average True Range act as the "exceedance" barrier.
Regime Boxes: The indicator automatically identifies "Quiet," "Normal," and "High Vol" regimes. These are visualized as colored boxes (defaulting to High Vol) to show the duration and range of specific volatility climates.
Significance Dots: Circles appear at the top of the chart to mark bars that have breached the volatility threshold.
🔹 Dashboard Metrics
A real-time dashboard provides quantitative data:
Exceedance Freq: The percentage of bars in the short-term window that breached the ATR levels.
Serial Break Prob: The historical probability that a breach will be followed by another breach (continuation).
Clustering Edge: The statistical advantage of volatility clustering; a positive value suggests that volatility is currently feeding on itself.
🔶 DETAILS
The VEPM operates on the principle that volatility is not constant but "clusters" in time. It uses the following logic to derive its metrics:
Exceedance Detection: It calculates whether the current price range (True Range) or price levels (High/Low) exceed a user-defined ATR multiplier.
Statistical Z-Score: By comparing the current frequency of these breaches to a long-term baseline (200 bars by default), the model calculates a Z-Score to determine if the current activity is statistically "abnormal."
Continuation Probability: The model looks back at previous breaches and calculates how often they resulted in immediate follow-through, providing a "Serial Break" percentage.
🔶 SETTINGS
🔹 Core Settings
ATR Length: The lookback period used for the Average True Range calculation.
ATR Multiplier: The threshold used to define what constitutes a "breach" or exceedance.
Breach Detection Method: Choose between comparing the bar's total range to ATR or checking if price levels exceed the previous bar's bands.
🔹 Statistical Windows
Short-Term Window: The period used to calculate the current exceedance frequency.
Baseline Window: The long-term period used to establish the "normal" mean of volatility frequency.
Z-Score Sensitivity: Determines the threshold for identifying statistically significant volatility spikes.
🔹 Visuals
Show ATR Bands: Toggles the visibility of the ATR-based levels on the chart.
Bands Mode: Determines if bands are offset from a central basis (SMA/EMA) or from the bar's High/Low.
Regime Box Options: Toggles background boxes for Quiet, Normal, or High Volatility regimes.
🔹 Dashboard
Dashboard: Enables or disables the on-screen information table.
Position/Size: Controls the location and scale of the dashboard UI.
אינדיקטור Pine Script®






















