From e5041335c4868cb8f2c9deb2d02d9db49581ac94 Mon Sep 17 00:00:00 2001 From: Toh4iem9 Date: Sat, 1 Aug 2026 19:25:39 +0200 Subject: [PATCH] new files added --- .../MyIndicators/Chandelier_Exit_Pro_Suite.md | 145 ++++++++++++++++++ 1 file changed, 145 insertions(+) create mode 100644 Indicators/MyIndicators/Chandelier_Exit_Pro_Suite.md diff --git a/Indicators/MyIndicators/Chandelier_Exit_Pro_Suite.md b/Indicators/MyIndicators/Chandelier_Exit_Pro_Suite.md new file mode 100644 index 0000000..90a2ba0 --- /dev/null +++ b/Indicators/MyIndicators/Chandelier_Exit_Pro_Suite.md @@ -0,0 +1,145 @@ +# 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**. + +```text + + 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**: + +```mql5 +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.