mql5/Indicators/MyIndicators/MovingAverage_MTF_Pro.md

Moving Average MTF Pro

1. Summary (Introduction)

The MovingAverage_MTF_Pro is a versatile multi-timeframe (MTF) version of our universal moving average indicator. It allows a trader to calculate one of the four fundamental moving average types (SMA, EMA, SMMA, LWMA) on a higher, user-selected timeframe and project it onto the current, lower-timeframe chart.

This provides a clear, smoothed-out view of the underlying trend from a broader perspective without needing to switch charts.

2. Mathematical Foundations and Calculation Logic

Core MA Types

• SMA: Simple Moving Average.
• EMA: Exponential Moving Average.
• SMMA: Smoothed Moving Average (Wilder's).
• LWMA: Linear Weighted Moving Average.

MTF Calculation Steps

1. Fetch Data: Retrieves OHLC data for the selected higher timeframe.
2. Calculate: Performs the recursive or standard calculation on the higher timeframe data.
3. Map: Projects the values to the current chart, creating a "step-like" visual representation.

3. MQL5 Implementation Details

• Self-Contained: No iCustom dependencies. Uses direct Copy... functions for stability.

• Universal Engine (MovingAverage_Engine.mqh): Reuses the core logic from the standard suite for consistency.

• Optimized Incremental Calculation (O(1)): This indicator is engineered for performance:

  • HTF State Tracking: Tracks htf_prev_calculated to avoid redundant math on the higher timeframe.
  • Persistent State: Preserves the recursive state of EMAs and SMMAs between ticks.
  • Smart Mapping: The projection loop handles index alignment precisely and only updates changed bars.

• Dual-Mode Logic: Automatically switches between MTF mode (projection) and Standard mode (direct calculation) based on the timeframe selection.

4. Parameters

• Upper Timeframe (InpUpperTimeframe): The calculation timeframe.
• Period (InpPeriod): The lookback period.
• MA Type (InpMAType): SMA, EMA, SMMA, or LWMA.
• Applied Price (InpSourcePrice): Standard or Heikin Ashi price sources.

5. Usage and Interpretation

• Trend Direction: A rising MTF MA indicates a bullish higher-timeframe trend; falling indicates bearish.
• Pullbacks: In an uptrend, a pullback to the MTF MA often represents a high-value buying opportunity (dynamic support).
• Crossovers: Price crossing the MTF MA can signal a potential reversal in the major trend.