Shadow Volume Reactor

 SHADOW VOLUME REACTOR
 Smart Volume Engine

Shadow Volume Reactor  introduces a paradigm shift in algorithmic trading. While the vast majority of Expert Advisors rely entirely on lagging price indicators (EMAs, RSI, MACD), Shadow focuses on the one data source that never lies: VOLUME. When a massive Volume Spike occurs (tick volume surging 150% or more above its recent average), it signifies that real institutional money is entering the market. Shadow reads the direction of that money flow and executes accordingly.

Designed as a Dual-Asset Reactor, Shadow can simultaneously monitor and trade both XAUUSD (Gold) and BTCUSD (Bitcoin) from a single chart, giving you exposure to the two most volatile and profitable assets on the planet.

=== WHY SHADOW VOLUME REACTOR? ===
1. VOLUME SPIKE DETECTION: The core algorithm continuously calculates the average Tick Volume over the last 20 H1 bars. When the current bar's volume exceeds the average by a configurable multiplier (default 1.5x), the EA flags it as a "Volume Spike." It then reads the candle's direction (bullish or bearish) and cross-references it with the H1 EMA Trend to confirm the institutional flow direction.
2. DUAL-ASSET REACTOR: Shadow operates as a One-Chart Engine. You only need one chart open. The EA will independently monitor and execute trades on both configured symbols (e.g., XAUUSD and BTCUSD). Each asset is managed with its own independent Virtual SL, Virtual TP, Break-even, and Trailing logic.
3. LINEAR SAFE EXECUTION: Maximum 1 position per asset. Zero Grid. Zero Martingale. Every trade is protected by a Hard Stop Loss. Your maximum risk per trade is mathematically defined.
4. TRAILING PROFIT LOCK: 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 Phantom Trailing Step secures progressively larger profits.
5. BASKET STEALTH (GHOST V3): All exit targets (Virtual TP, Virtual SL, Break-even, and Trailing) are managed entirely within the EA's internal memory. The broker sees only open tickets with no predefined limits, fully protecting your execution from stop-hunting tactics.

---

- Volume Limit Safety:- Enforced MQL5 compliance with SYMBOL_VOLUME_LIMIT clamping in RunTesterValidation() to ensure flawless Market validation.
- Market Closed Protection:- Added SYMBOL_TRADE_MODE checks to prevent execution errors and invalid indicator reads during off-market hours.
- Order Modification Guard:- Restructured Spread logic: min_dist = max(stops_level, freeze_level) + spread + 30 to eliminate all "Invalid stops" errors.
- Data-Backed Defaults:- Dual-Asset configuration validated and optimized via Python backtesting engine.

 === GOD-TIER PRESETS ===

[SETUP 1] SHADOW PRIME (Recommended)
Balanced Volume detection for Gold + Bitcoin. The most consistent performer in backtesting.
- Sym1:- XAUUSD / Sym2:- BTCUSD
- VolAvgBars:- 20 / VolMultiplier:- 1.5 / TrendEma:- 50
- StartLot:- 0.05 / HardSlPts:- 1000 / VirtualTPPts:- 2000
- BETriggerPts:- 300 / BEProfitPts:- 50
- UseTrailing:- true / TrailStartPts:- 500 / TrailDistPts:- 200
- GhostMode:- true / MaxDailyDD:- 6.0

[SETUP 2] GOLD WHISPER (Conservative - Gold Only)
Strict volume requirements for XAUUSD. Waits for extreme institutional activity (200%+ spikes).
- Sym1:- XAUUSD / Sym2:- (leave blank)
- VolAvgBars:- 30 / VolMultiplier:- 2.0 / TrendEma:- 100
- StartLot:- 0.05 / HardSlPts:- 800 / VirtualTPPts:- 3000
- BETriggerPts:- 200 / BEProfitPts:- 20
- UseTrailing:- true / TrailStartPts:- 400 / TrailDistPts:- 150
- GhostMode:- true / MaxDailyDD:- 3.0

[SETUP 3] VOLUME STORM (Aggressive - Dual Asset)
Lower spike threshold (120%), captures more opportunities across both assets.
- Sym1:- XAUUSD / Sym2:- BTCUSD
- VolAvgBars:- 14 / VolMultiplier:- 1.2 / TrendEma:- 21
- StartLot:- 0.10 / HardSlPts:- 1200 / VirtualTPPts:- 1500
- BETriggerPts:- 400 / BEProfitPts:- 100
- UseTrailing:- true / TrailStartPts:- 600 / TrailDistPts:- 300
- GhostMode:- true / MaxDailyDD:- 15.0

---

 === INSTALLATION & SETUP ===
1. Open ANY chart in MetaTrader 5 on the H1 timeframe.
2. Drag and drop Shadow Volume Reactor onto the chart.
3. In the Inputs tab, enter your broker's exact Gold symbol name in InpSym1 (e.g., XAUUSD) and BTC symbol in InpSym2 (e.g., BTCUSD). Leave InpSym2 blank to trade only Gold.
4. Choose a God-Tier Preset above.
5. Ensure "Allow Algo Trading" is checked.
6. Run on a VPS 24/5. Ghost Protocol requires the terminal to remain open continuously.

=== IMPORTANT NOTES ===
- The EA will display "SCANNING VOLUME POOLS" while it waits for a Volume Spike to occur on either asset.
- When a spike is detected and a trade is opened, you will see "VOLUME SPIKE ENGAGED" on the dashboard.
- Each asset is tracked independently on the dashboard with its own PnL reading.
- Ghost Protocol manages exits internally. You will NOT see SL/TP lines on your broker's chart.