forex-scalping.com

Code: Select all

using System;
using cAlgo.API;
using cAlgo.API.Internals;
using cAlgo.API.Indicators;

namespace cAlgo
{
    [Indicator(IsOverlay = true, TimeZone = TimeZones.UTC, AccessRights = AccessRights.None)]
    public class XAGRegimeFilter : Indicator
    {
        // --- Normative Baseline Parameters ---
        [Parameter("Rolling ATR Lookback", Group = "Normative Baseline Parameters", DefaultValue = 20)]
        public int BaselineLength { get; set; }

        [Parameter("Deviation Multiplier", Group = "Normative Baseline Parameters", DefaultValue = 2.0)]
        public double AtrMultiplier { get; set; }

        // --- Velocity Parameters ---
        [Parameter("Velocity Lookback (Pace)", Group = "Velocity Parameters", DefaultValue = 3)]
        public int MomentumLookback { get; set; }

        // --- Output Buffers ---
        // Exposing the buffer allows automated cBots to read this regime filter directly.
        [Output("De-risk Signal", LineColor = "Maroon", PlotType = PlotType.Points, Thickness = 4)]
        public IndicatorDataSeries SignalBuffer { get; set; }

        private AverageTrueRange _atr;
        private int _lastAlertIndex = -1;

        protected override void Initialize()
        {
            // Initialize the ATR utilizing Wilder's Smoothing (industry standard for ATR)
            _atr = Indicators.AverageTrueRange(BaselineLength, MovingAverageType.Wilder);
        }

        public override void Calculate(int index)
        {
            // Insufficient data guard
            if (index < BaselineLength || index < MomentumLookback)
            {
                SignalBuffer[index] = double.NaN;
                return;
            }

            // 1. Establish the Baseline Regime
            double baselineAtr = _atr.Result[index];

            // 2. Measure Intraday Expansion (Range Anomaly)
            double currentRange = Bars.HighPrices[index] - Bars.LowPrices[index];
            bool isRangeAnomalous = currentRange > (baselineAtr * AtrMultiplier);

            // 3. Measure Directional Velocity (Pace Anomaly)
            double momentum = Math.Abs(Bars.ClosePrices[index] - Bars.ClosePrices[index - MomentumLookback]);
            bool isPaceAnomalous = momentum > (baselineAtr * AtrMultiplier);

            // 4. Trigger: Confluence of Outsized Range and Extreme Velocity
            bool isRegimeShift = isRangeAnomalous && isPaceAnomalous;

            if (isRegimeShift)
            {
                // Calculate geometric placement above the wick
                double markerPlacement = Bars.HighPrices[index] + (baselineAtr * 0.5);
                
                // Write to program buffer
                SignalBuffer[index] = markerPlacement;
                
                // Paint a distinct visual icon on the chart UI
                Chart.DrawIcon("RegimeShift_" + index, ChartIconType.Diamond, index, markerPlacement, Color.Maroon);

                // Alert Engine: Log only once per live bar to prevent tick-spam
                if (IsLastBar && _lastAlertIndex != index)
                {
                    Print("XAG Regime Shift Alert | Anomalous Range & Velocity detected. Tag: xag_squeeze. Reduce size.");
                    _lastAlertIndex = index;
                }
            }
            else
            {
                // Cleanly clear non-triggered buffer states
                SignalBuffer[index] = double.NaN;
            }
        }
    }
}