mql5/Indicators/MyIndicators/Chandelier_Exit_Pro_Suite.md

Charles LeBeau's Chandelier Exit & Distance Oscillator Pro Suite (Standard & MTF)

1. Summary (Introduction)

The Charles LeBeau's Chandelier Exit & Distance Oscillator Pro Suite is an institutional-grade, low-latency trend-following, risk-management, and cyclical momentum tracking suite. It comprises two highly synchronized indicators: Chandelier_Exit_Pro (plotted on the main chart) and Chandelier_Exit_Oscillator_Pro (plotted in a separate subwindow).

Developed by Charles LeBeau, the Chandelier Exit is a stateful trailing stop-loss system designed to keep traders in a trend until a definitive cyclical reversal occurs. It operates on the logic that a trailing stop should be hung from the absolute highest high (or lowest low) of the trend, mimicking a chandelier hanging from a ceiling.

While the main chart indicator manages trailing stops, the Chandelier Distance Oscillator measures the normalized distance between the close price and the trailing stop line in units of average volatility (ATR).

By upgrading the legacy retail logic with our proprietary Active-Line Reversal Rule, the suite completely eliminates the traditional "sawtooth death-loop" during high-volatility regimes. Coupled with a 5-zone swapped thermal color palette, the suite provides a flawless mathematical representation of trend health, velocity, and execution risk.

---

2. Mathematical & Quant Foundations

The suite calculations are performed recursively, combining extreme lookback ranges with smoothed Average True Range (ATR) volatility.

A. Core Volatility Baseline (ATR)

The baseline volatility is calculated using the standard Wilder's smoothed ATR over the configured period (N):

\text{TR}_t = \max \big( (H_t - L_t), |H_t - C_{t-1}|, |L_t - C_{t-1}| \big) \text{ATR}_t = \frac{\text{ATR}_{t-1} \times (N - 1) + \text{TR}_t}{N}

B. Raw Chandelier Exit Bands

The raw long and short stop bands are hung from the highest high (or lowest low) over the lookback period N, using the ATR multiplier (\kappa):

\text{LongStop}_t = \max_{j=0 \dots N-1} (H_{t-j}) - \kappa \times \text{ATR}_t \text{ShortStop}_t = \min_{j=0 \dots N-1} (L_{t-j}) + \kappa \times \text{ATR}_t

C. The Chandelier Distance Oscillator

The companion oscillator measures the distance of the close price relative to the active stop line, normalized in standard volatility units:

\text{Chandelier Oscillator}_t = \frac{P_t - \text{StopLine}_t}{\text{ATR}_t}

Where P_t is the close price (Standard or Heikin Ashi). Because \text{ATR}_t > 1.0e-9, division-by-zero exceptions are strictly prevented.

---

3. Quant Paradigm Shift: Volatility Velocity vs. Mean Reversion

A critical, highly sophisticated distinction exists between the Chandelier Distance Oscillator and standard Z-Score oscillators (such as the L-Score):

A. Standard Z-Score (Mean-Reverting Model)

Standard Z-Score oscillators measure price distance relative to a moving average mean (which sits in the center of price action). Because the mean acts as a gravitational anchor, extreme positive or negative peaks (e.g., \ge \pm2.5) represent high-probability exhaustion points where the price is statistically stretched and must regress back to its mean (Mean Reversion).

B. Chandelier Distance Oscillator (Trend-Following Momentum Model)

The Chandelier Oscillator measures price distance relative to a trailing stop (which sits below price in a bullish trend and above price in a bearish trend).

• The Ceiling Phenomenon: During a highly efficient trend breakout, the price expands rapidly away from the stop line. The oscillator spikes to its maximum potential ceiling (equivalent to the multiplier coefficient, \pm \kappa).
• Trend Continuation: As long as the trend remains powerful and consistent, the price maintains its distance from the trailing stop. The oscillator does not revert; instead, it plateaus at its ceiling (forming flat, extended peaks).
• The Trading Logic: Consequently, a peak in the Chandelier Oscillator does not signify a reversal. It represents maximum trend velocity and strong continuation. A contraction back towards the zero-line (e.g., from +2.5 to +1.0) represents a temporary, healthy trend consolidation (price pulling back to test its stop-loss floor). A true trend reversal is triggered strictly and only when the oscillator crosses the zero (0.0) line.

    Mean Reversion (LScore):     [Peak/Extreme Deviation]  ====>  Expected Reversal (Pivot)
    Trend Following (Chandelier): [Peak/Ceiling Plateau]   ====>  Strong Trend Continuation

---

4. Visual Symmetrical 5-Zone Thermal Matrix

To track trend velocity and consolidation risk, the oscillator histogram is mapped to a 5-zone swapped thermal color palette (matching the exact colors of our institutional suite):

Color Index	Oscillator State	Mathematical Condition	Visual Representation
0.0	Neutral / Consolidation	\text{Osc}_t \le 1.5	clrGray (Price is consolidating close to the Stop)
1.0	Bullish Flow	\text{Osc}_t > 1.5 \quad \text{AND} \quad \text{Osc}_t \le 2.0	clrLightSkyBlue (Stable, healthy uptrend)
2.0	Bullish Climax (Ceiling)	\text{Osc}_t > 2.0	clrDeepSkyBlue (High-velocity, explosive uptrend)
3.0	Bearish Flow	\text{Osc}_t < -1.5 \quad \text{AND} \quad \text{Osc}_t \ge -2.0	clrCoral (Stable, healthy downtrend)
4.0	Bearish Climax (Ceiling)	\text{Osc}_t < -2.0	clrOrangeRed (High-velocity, explosive downtrend)

---

5. Advanced MQL5 Engineering: The Active-Line Reversal Rule

Standard retail Chandelier Exit indicators suffer from a severe logical flaw: during violent trend reversals, they permit the trend to flip falsely, creating a "sawtooth death-loop" where the stop line oscillates up and down on every bar, destroying the chart's readability and corrupting the oscillator's output.

A. The Retail Sawtooth Trap

If the trend is Bearish (Stop line is high above price), and a sudden volatile spike occurs, the price crosses above the deep ShortStop sáv, triggering a bullish flip. However, because the trade was just entered, the LongStop is calculated using Highest(High) of the last 22 bars. Because of the recent crash, the Highest(High) is still the pre-crash high (extremely high).

The bullish stop line is suddenly plotted above the price. On the very next bar, the engine detects that the price is below the bullish stop, and immediately flips back to Bearish. This repeats continuously.

B. The Active-Line Reversal Safeguard

Our refactored Chandelier_Exit_Calculator.mqh solves this by implementing the Symmetrical Active-Line Reversal Rule. A trend flip is strictly permitted only if the price crosses the active trailing stop line AND the new stop line would lie on the correct side of the price:

if(prev_trend == 1.0) // Trend was Bullish (Stop is below price)
  {
   // Flip to bearish ONLY if price closes BELOW active stop AND the new bearish stop is safely ABOVE price
   if(m_price_close[i] < prev_stop && m_short_stop[i] > m_price_close[i])
     {
      m_trend[i]   = -1.0;
      stop_line[i] = m_short_stop[i]; // Reset to ShortStop
     }
   else
     {
      m_trend[i]   = 1.0;
      stop_line[i] = MathMax(m_long_stop[i], prev_stop); // Ratchet
     }
  }

This guarantees that a Bullish stop is always below the price, a Bearish stop is always above the price, and the "sawtooth death-loop" is 100% eliminated, producing clean, smooth, staircase steps even on extremely volatile assets like Bitcoin (BTCUSD).

---

6. Symmetrical Quantitative Trading Strategies

A. The Volatility Breakout Zero-Crossing Trigger (Trend Initiation)

This strategy captures the exact beginning of high-velocity trend expansions.

1. Indicator Setup:
   • Chandelier Exit Pro: Period = 22, Multiplier = 3.0, Source = PRICE_CLOSE_STD.
   • Chandelier Exit Oscillator Pro: Same settings, Signal Line = Enabled (Slowing = 5, Type = LWMA).
2. Execution Rules:
   • BUY Trigger: Enter Long when the Chandelier Oscillator crosses above the 0.0 line (transitioning from Coral/OrangeRed to DodgerBlue/LightSkyBlue). This confirms that price has broken the Trailing Stop, initiating a fresh Bullish trend.
   • SELL Trigger: Enter Short when the Chandelier Oscillator crosses below the 0.0 line.
3. Risk Management:
   • Place the Stop Loss exactly at the newly plotted Chandelier Trailing Stop line on the main chart.
   • Trail the stop in real-time as the trend expands.

B. The Institutional Pullback Reentry (Flow Zone Touch)

This strategy utilizes the "deceleration pullback" to enter an ongoing trend at the optimal risk-to-reward ratio.

1. Indicator Setup:
   • Same indicators loaded. Period = 22, Multiplier = 2.5.
2. Execution Rules:
   • BUY Entry (Bullish Pullback): In an established Bullish trend (oscillator has been plateauing in the clrDeepSkyBlue climax zone above 2.0):
     • Wait for a corrective pullback where the price drops close to the stop line, causing the oscillator to contract from the climax zone into the Neutral/Consolidation Zone (|\text{Osc}_t| \le 1.5 / clrGray bars).
     • Trigger: Enter Long on the first bar where the histogram turns back to clrLightSkyBlue (crossing above 1.5 with a bullish bounce), or when the histogram crosses above its LWMA Signal Line from below.
3. Strategic Advantage: Entering during the consolidation pullback allows you to enter the ongoing trend at a minimal distance from the stop-loss floor, achieving an ultra-tight risk profile while riding the institutional trend continuation.