OPEN-SOURCE SCRIPT

ATR Exceedance Probability Model [LuxAlgo]

11 059
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:

  1. Exceedance Detection: It calculates whether the current price range (True Range) or price levels (High/Low) exceed a user-defined ATR multiplier.
  2. 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."
  3. 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.

Wyłączenie odpowiedzialności

Informacje i publikacje nie stanowią i nie powinny być traktowane jako porady finansowe, inwestycyjne, tradingowe ani jakiekolwiek inne rekomendacje dostarczane lub zatwierdzone przez TradingView. Więcej informacji znajduje się w Warunkach użytkowania.