diff --git a/Indicators/MyIndicators/Quant/WeisWave_CumulativeDelta_Pro.md b/Indicators/MyIndicators/Quant/WeisWave_CumulativeDelta_Pro.md new file mode 100644 index 0000000..03ea460 --- /dev/null +++ b/Indicators/MyIndicators/Quant/WeisWave_CumulativeDelta_Pro.md @@ -0,0 +1,90 @@ +# Weis Wave Cumulative Delta Pro (Indicator) + +## 1. Summary (Introduction) + +The **Weis Wave Cumulative Delta Pro** is an institutional-grade, high-frequency volume-flow oscillator based on Richard Wyckoff's first law—**The Law of Supply and Demand**—and David Weis's wave mechanics. + +While traditional volume oscillators (like On-Balance Volume - OBV) accumulate volume based on simple candle-by-candle close prices (introducing massive noise and false signals), `WeisWave_CumulativeDelta_Pro` aggregates volume strictly along **ATR-defined price waves** (swing legs). By summing volume on upward waves and subtracting it on downward waves, the indicator filters out intraday noise and tracks the long-term cumulative net trend of institutional money flow (Smart Money Flow). + +The indicator features a highly optimized $O(1)$ real-time mathematical engine, a dynamically colored trend line (Green when rising, Red when falling), and a bulletproof, gap-resistant bar-time synchronization module. + +--- + +## 2. Mathematical Foundations and Wave Mechanics + +The mathematical structure of the Cumulative Delta ($\Delta$) is computed continuously at each bar $t$ by integrating the active wave direction ($D_t$) and the volume ($V_t$): + +### A. Wave-Filtered Cumulative Delta Formula + +$$\Delta_t = \Delta_{t-1} + (D_t \times V_t)$$ + +Where: + +* $V_t$ = The volume (Real Volume or Tick Volume) of the current bar $t$. +* $D_t \in \{1, -1\}$ = The active swing leg direction determined by the ATR-based state machine: + * $D_t = 1$ (Up Wave / Demand): Volume is added to the cumulative net sum. + * $D_t = -1$ (Down Wave / Supply): Volume is subtracted from the cumulative net sum. + +### B. ATR-Based Reversal Threshold + +The swing leg direction is determined dynamically using a multiplier $M$ (`InpMultiplier`) of the Average True Range (ATR): + +$$\text{Threshold}_t = M \times \text{ATR}_t$$ + +* **Up Swing to Down Swing Reversal:** Triggers when the price drops below the wave's peak high minus the threshold: + $$C_t < \max(H_{\text{wave}}) - \text{Threshold}_t$$ +* **Down Swing to Up Swing Reversal:** Triggers when the price rises above the wave's trough low plus the threshold: + $$C_t > \min(L_{\text{wave}}) + \text{Threshold}_t$$ + +Once a reversal is triggered, the direction changes, and the volume continues to accumulate in the opposite mathematical direction. + +--- + +## 3. MQL5 UI & Architecture + +* **Decoupled Math Engine (`WeisWave_CumulativeDelta_Calculator.mqh`):** + All wave tracking, volume direction routing, and cumulative integration logic are encapsulated inside the highly optimized `CWeisWaveDeltaCalculator` include class. + +* **Strict $O(1)$ Real-Time Tick Optimization:** + To support live-updating while preserving performance, the indicator computes only the **current live bar** (index `rates_total - 1`) on every tick. This keeps CPU usage at absolute zero, allowing the Cumulative Delta to tick-by-tick accumulate live in real-time. + +* **100% Non-Repainting and EA-Compatible:** + Unlike traditional Zigzag-based indicators, `WeisWave_CumulativeDelta_Pro` locks all wave and delta states into historical arrays once a bar closes. The historical line is permanently locked and never repaints, making the indicator 100% reliable for backtesting and automated Expert Advisors (EAs). + +* **Dynamic Color Line Rendering:** + To provide maximum visual clarity, the oscillator line is drawn using a high-precision `DRAW_COLOR_LINE` plot style: + * **LimeGreen:** Rising Cumulative Delta ($\Delta_t \ge \Delta_{t-1}$), signaling dominant buying pressure. + * **Crimson:** Falling Cumulative Delta ($\Delta_t < \Delta_{t-1}$), signaling dominant selling pressure. + +--- + +## 4. Parameters + +* **ATR Period (`InpATRPeriod`):** The lookback period used to calculate the dynamic Average True Range (Default: `14` bars). +* **Multiplier (`InpMultiplier`):** The number of ATRs required to trigger a wave reversal (Default: `2.5`). Lower values capture micro-swings; higher values filter out intraday consolidations. + +--- + +## 5. Advanced Trading & Divergence Strategies + +The Cumulative Delta is the ultimate **Smart Money Divergence Filter**, used to spot when institutional accumulation/distribution is occurring under cover of retail price action. + +### A. The Bullish Divergence (Accumulation Setup) + +* **The Setup:** The price makes a new lower low (e.g. breaking support), but the Cumulative Delta line makes a **significantly higher low** (and turns Green). +* **The Interpretation:** Retail traders are panic-selling, but the "Composite Man" (institutions) is absorbing all the supply and accumulating positions without pushing the price up yet [1]. +* **Action:** Prepare to **BUY (Long)** as soon as the price stabilizes. + +### B. The Bearish Divergence (Distribution Setup) + +* **The Setup:** The price makes a new higher high (e.g. breaking resistance), but the Cumulative Delta line makes a **significantly lower high** (and turns Red). +* **The Interpretation:** Retail traders are buying the breakout, but institutions are distributing (selling) their positions, capping the net volume flow. +* **Action:** Prepare to **SELL (Short)** as soon as the price rolls over. + +### C. Synergy with Weis Wave SOT Pro + +By placing `WeisWave_Pro` (with integrated SOT highlighting) and `WeisWave_CumulativeDelta_Pro` on the same chart, traders have a complete Wyckoff terminal: + +* **The Trigger:** If the standard Weis Wave turns **Orange/Fuchsia**, signaling a **Shortening of the Thrust (SOT)** wave exhaustion. +* **The Confirmation:** If the Cumulative Delta simultaneously confirms a **Bullish/Bearish Divergence**. +* **Result:** This dual confirmation represents one of the highest-probability trend-reversal setups in the Wyckoff methodology, allowing traders to enter exactly at the "danger point" with minimal risk.