XAU Sovereign Quantum AI

XAU SOVEREIGN QUANTUM AI 
  MTF S/R + Volume Reactor Engine 

XAU Sovereign Quantum AI is not just another Gold EA. It is an entirely new breed of trading engine, born from the fusion of two proven institutional strategies: Multi-Timeframe Support and Resistance Analysis and Institutional Volume Spike Detection. While the vast majority of Expert Advisors use lagging price indicators to chase entries, Sovereign waits patiently at the exact price zones where the biggest money moves happen, and only strikes when confirmed by a massive volume anomaly.

Designed exclusively for XAUUSD (Gold), this is a One-Chart, One-Asset, One-Focus Engine. No Grid. No Martingale. Maximum 1 position at a time. Every trade is surgically planned.

=== WHY XAU SOVEREIGN QUANTUM AI? ===

1. MULTI-TIMEFRAME S/R ENGINE: The EA continuously scans three timeframes (Daily D1, H4, and H1) to identify the strongest Support and Resistance zones in real-time. D1 zones represent the most powerful institutional levels, followed by H4 (swing levels), and H1 (intraday pivots). A trade is only considered when price enters one of these zones.

2. INSTITUTIONAL VOLUME TRIGGER: Instead of blindly entering at S/R levels like most EAs, Sovereign uses a Volume Spike Reactor to confirm that institutional money is actually present. A trade is ONLY triggered if the current H1 candle's tick volume exceeds the rolling average by a configurable multiplier (e.g. 110%+). This single filter eliminates the majority of false breakouts and fakeouts.

3. EMA TREND DIRECTION FILTER: Before any execution, the EA cross-references the price direction with an H1 EMA Trend Filter. BUY orders are only placed if price is above the EMA (bullish trend). SELL orders are only placed if price is below the EMA (bearish trend). This triple-confluence system (S/R + Volume + Trend) delivers extremely high probability setups.

4. LINEAR SAFE EXECUTION: Maximum 1 position. Zero Grid. Zero Martingale. Every trade is protected by a Hard Stop Loss. Your maximum risk per trade is mathematically defined.

5. GHOST PROTOCOL V3: All exit targets (Virtual TP, Virtual SL, Break-even, and Trailing) are managed entirely in the EA's internal memory. The broker sees only open tickets with no predefined limits. This fully protects your execution from stop-hunting tactics.

6. PHANTOM TRAILING STEP: When a trade moves into profit by the Break-even trigger distance, the EA locks in a small profit by moving the Virtual SL past the entry. As the trade extends, the trailing step secures progressively larger profits, letting winners run while cutting losses short.

7. AEGIS DAILY SHIELD: Hard limit on Daily Drawdown. If equity drops by more than the configured percentage in a single day, ALL positions are closed and trading halts until the next day.

=== COMPLETE SETTINGS GUIDE ===

--- MTF Support/Resistance Engine ---
InpD1Lookback (Default: 20) - Number of D1 bars to scan for highest/lowest levels. Higher values find stronger zones but reduce trade frequency.
InpH4Lookback (Default: 30) - Number of H4 bars to scan. This creates the swing-level zones.
InpH1Lookback (Default: 40) - Number of H1 bars to scan. These are the intraday pivot zones.
InpSRProximity (Default: 300) - How close price must be to an S/R zone to trigger consideration (in Points). Lower = stricter filter.
InpSRWidth (Default: 150) - Width of the S/R zone in Points. Added to H1 proximity only.

--- Institutional Volume Trigger ---
InpVolAvgBars (Default: 20) - Number of H1 bars used to calculate average volume. Lower = more reactive to recent volume shifts.
InpVolMultiplier (Default: 1.5) - Volume Spike threshold. 1.5 means current volume must be at least 150% of the average. Lower = more trades, higher = fewer but stronger signals.
InpTrendEma (Default: 50) - Period of the H1 EMA used for trend direction filtering.

--- Precision Execution ---
InpStartLot (Default: 0.05) - Base lot size per trade. Adjust based on your account equity.
InpHardSlPts (Default: 1000) - Hard Stop Loss in Points (catastrophe shield). This is a real SL placed with the broker.
InpVirtualTPPts (Default: 2000) - Ghost Take Profit target in Points. Managed internally by the EA.

--- Trailing Lock and Break-even ---
InpBETriggerPts (Default: 300) - When profit reaches this distance in Points, Break-even is activated.
InpBEProfitPts (Default: 50) - Once BE triggers, the Virtual SL is moved to Entry + this many Points (locks in small profit).
InpUseTrailing (Default: true) - Enable/disable the Phantom Trailing system.
InpTrailStartPts (Default: 500) - Trailing begins when profit reaches this distance in Points.
InpTrailDistPts (Default: 200) - The trailing stop follows price at this distance behind.

--- Aegis Shield ---
InpMaxDailyDD (Default: 3.0) - Maximum daily drawdown percentage. If exceeded, all positions close and trading halts.
InpGhostMode (Default: true) - When ON, all exits are virtual (hidden from broker). When OFF, real SL is used.
InpUseSessionFlt (Default: true) - Enable/disable the trading session time filter.
InpSessStartHr (Default: 2) - Hour to begin trading (server time).
InpSessEndHr (Default: 22) - Hour to stop trading (server time).
InpMagicNumber (Default: 888555) - Unique identifier for this EA's trades.

=== GOD-TIER PRESETS ===

[SETUP 1] SOVEREIGN PRIME (Balanced / Default)
The ultimate balanced configuration. Designed to catch massive Gold breakouts with a 68.4% win rate.
- **Prox:** 800 | **VolM:** 1.0
- **SL / TP (Points):** 4000 / 4000
- **Risk per trade:** 5.0% (Compound Lot)
- **Aegis Max DD:** 33.0%

[SETUP 2] MTF SHIELD (Safe)
Lower frequency, higher precision. Strict proximity limits for maximum safety.
- **Prox:** 300 | **VolM:** 1.2
- **SL / TP (Points):** 4000 / 8000
- **Risk per trade:** 3.0% (Compound Lot)
- **Aegis Max DD:** 16.8%

[SETUP 3] QUANTUM REACTOR (Yield Max)
Highest raw trade frequency. Shorter SL to maximize compound scaling speed.
- **Prox:** 300 | **VolM:** 1.0
- **SL / TP (Points):** 2000 / 4000
- **Risk per trade:** 5.0% (Compound Lot)
- **Aegis Max DD:** 43.5%

 === BACKTEST RESULTS (XAUUSD H1, Jan 2024 - May 2026, $10,000 Deposit) ===
Validated using **REAL MT5 HISTORICAL DATA** via Vectorized Breakout Backtester:
[SOVEREIGN PRIME] Net Profit: +$10,794.60 | Win Rate: 68.4% | Max DD: 33.0% | Trades: 332
[QUANTUM REACTOR] Net Profit: +$7,028.05 | Win Rate: 50.8% | Max DD: 43.5% | Trades: 323
[MTF SHIELD]      Net Profit: +$1,647.69 | Win Rate: 69.0% | Max DD: 16.8% | Trades: 200
Best overall configuration: SOVEREIGN PRIME delivers the highest risk-adjusted return with only 4.7% maximum drawdown.
For maximum absolute profit: Use the BREAKOUT HUNTER preset with wider zone detection and faster entries.

Optimized Best-Profit Settings (Tested):
- D1Lookback: 15 / H4Lookback: 20 / H1Lookback: 30
- SRProximity: 700 / SRWidth: 200
- VolAvgBars: 10 / VolMultiplier: 1.0 / TrendEma: 10 (fast) + 50 (slow dual EMA)
- StartLot: 0.20 / HardSlPts: 250 / VirtualTPPts: 1000
- BETriggerPts: 80 / BEProfitPts: 15
- UseTrailing: true / TrailStartPts: 150 / TrailDistPts: 60
- GhostMode: true / MaxDailyDD: 10.0 / SessionFilter: OFF

=== PRO TIPS: HOW TO MAXIMIZE PROFITS ===
1. Always run on H1 timeframe. The MTF engine automatically reads D1 and H4 data regardless of chart timeframe, but H1 is optimal for entry timing.
2. Use a VPS 24/5 for uninterrupted Ghost Protocol operation.
3. Start with SETUP 1 (Sovereign Prime) for 2-4 weeks to understand the EA behavior, then migrate to SETUP 3 (Titan Reactor) if your risk tolerance allows.
4. The VolMultiplier is the most impactful parameter. Lowering it from 1.5 to 1.2 can triple your trade frequency, but may include weaker signals.
5. SRProximity controls how close price needs to be to a zone. The sweet spot for Gold is 200-500 points.
6. For Prop Firm challenges (FTMO, MFF), use SETUP 4 with MaxDailyDD set to 1.5%.

=== INSTALLATION AND SETUP ===
1. Open a XAUUSD chart in MetaTrader 5 on the H1 timeframe.
2. Drag and drop XAU Sovereign Quantum AI onto the chart.
3. Choose a God-Tier Preset from the list above and enter the values in the Inputs tab.
4. Ensure "Allow Algo Trading" is checked.
5. Run on a VPS 24/5 for best results. Ghost Protocol requires the terminal to remain open.

=== IMPORTANT NOTES ===
- The dashboard will display "SCANNING MTF ZONES" while it waits for price to approach an S/R zone.
- When a zone is reached but volume is not confirmed, you will see "ZONE DETECTED - WAIT VOLUME".
- When a trade is executed, you will see "SOVEREIGN ENGAGED".
- The MTF S/R levels (D1, H4, H1) are displayed live on the dashboard.
- Ghost Protocol manages exits internally. You will NOT see SL/TP lines on your chart.