TrendMaster HF Scalper Ultimate Edition

==============================================================

   TrendMaster MT5 HF Scalper v2.19

   Multi-Symbol High-Frequency Trend-Following Scalper

==============================================================

[Version] v2.19

[Platform] MetaTrader 5

[Timeframe] M5 (5-minute chart)

[Symbols] EURUSD / GBPUSD / XAUUSD (Gold)

==============================================================

  Overview

==============================================================

TrendMaster MT5 HF Scalper is a multi-symbol high-frequency

trend-following trading system designed for the M5 timeframe.

It operates simultaneously on EURUSD, GBPUSD, and XAUUSD,

capturing short-term trend waves through fast EMA crossovers,

RSI momentum, MACD confirmation, and H4 multi-timeframe trend

filtering.

The system employs a virtual SL/TP management mechanism,

combined with safety-net physical stop loss, per-symbol

independent risk control, and dynamic profit protection —

forming a multi-layered risk management framework that

pursues returns while strictly controlling downside risk.

Through nine iterations from v2.11 to v2.19, the system has

evolved into a mature "Pure SL/TP Exit + Dynamic Profit

Guard" trading framework.

==============================================================

  Core Trading Logic

==============================================================

1. Signal System

  - Fast EMA crossover (3/8 or 5/13) detects trend initiation

  - RSI momentum confirms direction strength

  - MACD histogram confirms momentum direction

  - H4 multi-timeframe trend filter avoids counter-trend trades

  - Signal scoring system: combines all indicators into a score

    Normal threshold: 25 points, Aggressive: 15 points

2. Entry Conditions

  - Signal score >= MinSignalScore (default 25)

  - Spread <= MaxSpread (default 50 points)

  - ATR volatility within reasonable range (0.1% - 3.0%)

  - Outside news release windows (optional)

  - Within trading session (optional)

  - Position count for symbol below limit (default 3)

  - Daily trade count below limit (default 10 per symbol)

  - Cooldown period elapsed (default 2 bars = 10 minutes)

  - Circuit breaker not triggered (4 losses raise threshold,

    6 losses pause trading)

3. Position Sizing

  - Fixed lots or risk percentage (default 0.3% risk per trade)

  - Maximum lots per trade (default 0.50)

  - Max 3 concurrent positions per symbol

  - Max 9 concurrent positions across all symbols

  - Adaptive risk adjustment

==============================================================

  Exit Mechanism (Seven Layers)

==============================================================

v2.19 uses a "Pure SL/TP + Dynamic Profit Guard" exit

framework. Positions only exit under the following conditions:

  Layer 1: Virtual Stop Loss (1x ATR)

    - Calculated from entry price and ATR

    - Virtual execution (no physical SL set, bypasses freeze level)

    - Checked every tick

  Layer 2: Virtual Take Profit (3x ATR)

    - 1:3 risk-reward ratio

    - Lets profits run fully to target

    - Virtual execution, market order on hit

  Layer 3: Safety-Net Physical SL (3x virtual SL distance)

    - Physical SL set at 3x the virtual SL distance

    - Protects positions even when EA is offline (MT5 closed)

    - Auto-checks and sets SL for existing positions on restart

  Layer 4: Per-Position Floating Loss Protection (per symbol)

    - EURUSD/GBPUSD: closes at 3.0% balance loss

    - XAUUSD: closes at 1.5% balance loss (tighter for gold)

    - Prevents excessive single-trade losses

  Layer 5: Dynamic Profit Guard (v2.19 NEW)

    - Tracks peak profit per position (highest floating profit)

    - Activates when peak profit reaches 1x ATR (~$20)

    - If profit drops below 60% of peak, closes to lock in profit

    - Prevents "earned $30 then lost $30" profit giveback

  Layer 6: Per-Symbol Total Floating Loss Protection

    - Checks each symbol's total floating loss independently

    - XAUUSD: closes all at 1.5% balance loss

    - EURUSD/GBPUSD: closes at 3.0% balance loss

    - Skips positions with profit > $20 (compromise solution)

    - One symbol triggering does not affect others

  Layer 7: Reverse Signal Exit

    - Closes losing positions when opposite signal appears

    - Only closes positions with profit < 0

==============================================================

  Risk Management System

==============================================================

1. Per-Symbol Independent Risk Control

  - Each symbol uses its own MaxFloatingLossPct threshold

  - XAUUSD: 1.5% (tight stop, gold volatility requires fast cutting)

  - EURUSD/GBPUSD: 3.0% (wider stop, forex needs recovery room)

  - Symbols do not affect each other's risk management

2. Circuit Breaker

  - 4 consecutive losses: auto-raise signal threshold by +10 (1 hour)

  - 6 consecutive losses: pause trading for 60 minutes

  - Any profitable trade: reset consecutive loss counter

3. Daily Risk Controls

  - Max daily loss: 3.0% (stops trading for the day)

  - Max drawdown: 15.0% (stops all trading)

  - Daily equity reset: resets drawdown baseline daily

  - Friday close: auto-close all positions at 22:00 Friday (optional)

4. Safety Mechanisms

  - Auto-close positions when EA is stopped/removed

  - Startup check for existing positions without SL

  - Auto-retry on close failure (handles transient errors)

  - Cooldown prevents repeated close attempts (30 sec, 5 sec for SL)

==============================================================

  Symbol Parameters

==============================================================

Each symbol has independently configured EMA, RSI, ATR params:

  Symbol    FastEMA  SlowEMA  RSI  ATR  SL Multi  TP Multi

  -------------------------------------------------------

  EURUSD      3        8      7    7      1         3

  GBPUSD      3        8      7    7      1         3

  XAUUSD      5       13      7    7      1         3

XAUUSD uses slightly slower EMAs (5/13) because gold's volatility

characteristics differ from forex pairs, requiring more stable

signal filtering.

==============================================================

  Trade Notifications

==============================================================

  - Terminal alert popup (Alert)

  - Email notification

  - Push notification

  - Open notification: symbol, direction, lots, SL points, score

  - Close notification: symbol, direction, profit/loss amount

==============================================================

  Real-Time Dashboard

==============================================================

The EA displays a live information panel on the chart:

  - Current positions (symbol, direction, floating P/L, virtual SL/TP)

  - Real-time signal scores

  - Position count per symbol

  - Daily trade statistics

  - Risk parameter status (safety SL, profit guard, circuit breaker)

  - Market session status

==============================================================

  Version History

==============================================================

v2.11  Foundation

  Virtual SL/TP system, market session detection, safe close

  -> Established virtual stop framework, bypasses freeze level

v2.12  Signal Optimization

  Signal scoring, price action confirmation, dynamic thresholds

  -> Improved entry signal quality, fewer low-quality trades

v2.13  Safety Mechanisms

  Safety-net physical SL, auto-close on EA stop, startup check

  -> Solved the critical issue of unprotected positions when offline

v2.14  Bug Fixes

  Virtual SL restoration, total floating loss check, close retry

  -> Fixed critical bugs like SL loss after restart

v2.15  Profitability Optimization

  TP multiplier 2->3 (1:3 RR), relaxed sell filter, delayed triggers

  -> Improved per-trade profit potential and risk-reward ratio

v2.16  Pure SL/TP Mode

  Disabled trailing stop, break-even, partial close

  -> Found these cut profits too early ($2-5), switched to pure SL/TP

v2.18  Per-Symbol Risk Control

  MaxFloatingLossPct per symbol (XAUUSD 1.5%, forex 3.0%)

  -> Different risk thresholds for different symbols

v2.19  Dynamic Profit Guard

  Profit Guard tracking peak profit, compromise total loss check

  -> Solves profit giveback: positions had profit but slid to loss

==============================================================

  Recommended Environment

==============================================================

  Platform: MetaTrader 5 (Build 3000+)

  Timeframe: M5

  Symbols: EURUSD, GBPUSD, XAUUSD

  Account: Hedging account type

  Min balance: $10,000+ recommended (lower for demo)

  VPS: Recommended for 24/7 operation

==============================================================

  Important Notes

==============================================================

1. Virtual SL/TP Mechanism

   This EA uses virtual stop loss/take profit (does not set

   physical SL/TP on the exchange) to bypass freeze level

   restrictions and enable more flexible stop management.

   A 3x-distance safety-net physical SL is set as a last line

   of defense, ensuring positions are protected even when the

   EA is offline.

2. Pure SL/TP Exit Mode

   Since v2.16, trailing stop, break-even, and partial close

   have been disabled. Testing showed these functions locked

   in tiny profits ($2-5) far below the TP target. Positions

   now run naturally to SL or TP, complemented by v2.19's

   Dynamic Profit Guard to prevent profit giveback.

3. Per-Symbol Parameter Tuning

   Default parameters are based on 6-month backtesting.

   Different brokers may have different spreads and tick values.

   Recommended adjustment ranges:

   - XAUUSD risk threshold: 1.0%-2.0%

   - EUR/GBPUSD risk threshold: 2.0%-4.0%

   - Profit Guard activation: 0.7-1.5 ATR

   - Profit retention: 50%-70%

4. Backtesting Recommendations

   - Use "Every tick based on real ticks" mode

   - Backtest at least 6 months of data

   - Test each symbol individually before combined operation

   - Note daylight saving time effects on trading sessions

==============================================================

  Parameter Reference

==============================================================

[Identity]

  EA_Name              EA name

  MagicNumber          Magic number (identifies EA's trades)

  TradeComment         Trade comment

[Symbol Settings]

  EnableEURUSD/GBPUSD/XAUUSD  Enable/disable each symbol

  EURUSD/GBPUSD/XAUUSD_Symbol Symbol name (blank=auto detect)

[Risk Management]

  UseFixedLots         Fixed lot mode

  FixedLots            Fixed lot size (0.10)

  RiskPercent          Risk per trade (0.3%)

  MaxRiskPercent       Max absolute risk (0.8%)

  MaxLotsPerTrade      Max lots per trade (0.50)

  MaxDailyLossPercent  Max daily loss (3.0%)

  MaxDrawdownPercent   Max drawdown (15.0%)

[Signal Parameters] (per symbol)

  FastMA/SlowMA        Fast/slow EMA periods

  RSI_Period           RSI period

  ATR_Period           ATR period

  ATR_SL_Multi         SL ATR multiplier (1)

  ATR_TP_Multi         TP ATR multiplier (3)

[Signal Confirmation]

  UseMACD              MACD confirmation

  UseMTF               H4 multi-timeframe confirmation

  MinSignalScore       Minimum signal score (25)

  AggressiveScore      Aggressive entry score (15)

[Filters]

  MaxSpread            Max spread (50 points)

  SessionFilter        Trading session filter

  VolatilityFilter     Volatility filter

  UseNewsFilter        News filter (MQL5 economic calendar)

[Position Management]

  MaxDailyTrades       Max daily trades per symbol (10)

  MaxPositionsPerSymbol Max positions per symbol (3)

  CooldownBars         Cooldown bars (2)

  UseReverseExit       Reverse signal exit

[Risk Enhancements]

  EU/GU/XU_MaxFloatLossPct  Per-symbol floating loss threshold

  CircuitBreakerLosses      Raise threshold after N losses (4)

  CircuitBreakerPause       Pause after N losses (6)

  UseSellFilter             Sell signal filter

  UseSafetyNetSL            Safety-net physical SL

  SafetyNetSLMulti          Safety SL multiplier (3x)

  CloseAllOnDeinit          Close all on EA stop

[Dynamic Profit Guard (v2.19)]

  UseProfitGuard           Enable profit guard

  ProfitGuardActivationATR Activation threshold (1.0 ATR)

  ProfitGuardRetainPct     Retention percentage (60%)

  ProfitGuardSkipAmt       Total loss check skip amount ($20)

[Notifications]

  NotifyMode           Notification method (Terminal/Email/Push)

  NotifyOnOpen         Notify on trade open

  NotifyOnClose        Notify on trade close

==============================================================