47 lines
2.5 KiB
Markdown
# PropNewsSpreadGuard (MT5 Expert Advisor)
| |||
| |||
Standalone, zero-DLL **MetaTrader 5** risk-protection utility engineered for algorithmic and prop-firm traders running automated EAs across major FX pairs and metals (`EURUSD`, `GBPUSD`, `USDJPY`, `XAUUSD`, `XAGUSD`).
| |||
| |||
Maintained by **[ForexNewsRadar](https://www.mql5.com/en/users/forexnewsradar)**.
| |||
| |||
---
| |||
| |||
## Live Chart HUD Preview
| |||
| |||
### 1. Calm Market (`SAFE · CLEAR`)
| |||

| |||
| |||
### 2. Active Macro / Spread Shock (`DO NOT TRADE · VETO`)
| |||

| |||
| |||
---
| |||
| |||
## Core Architecture
| |||
| |||
1. **Pre-News & Post-News Blackout (`T-5m` / `T+5m`):** Reads the native MetaTrader 5 Economic Calendar (`CalendarValueHistory`) for currencies matching the chart symbol (including automatic `USD` mapping on `XAUUSD` / `XAGUSD`) and activates a configurable pre-release and post-release cooldown window.
| |||
2. **Dynamic Spread-Spike & Liquidity Vacuum VETO:** Computes a calm-regime rolling EMA of live broker spread (`SYMBOL_SPREAD`) without polluting the baseline during news spikes, triggering `SPREAD_VETO` whenever spread breaches either your hard point cap (`InpMaxSpreadPoints`) or dynamic multiplier (`InpSpreadSpikeMultiplier`).
| |||
3. **Non-Destructive Pending-Order Sweeper:** Optionally clears unfilled pending stop/limit orders (`Buy Stop`, `Sell Stop`, `Buy Limit`, `Sell Limit`) during active `PRE_NEWS` or `SPREAD_VETO` windows while **never closing or modifying already open positions**. Supports filtering by `MagicNumber` (`-1` = all pending orders on symbol).
| |||
4. **Cross-EA Terminal RAM Bridge (`GlobalVariableSet`):** Publishes `FNR_GUARD_SAFE_<SYMBOL>` (`1.0` = safe to open new trades, `0.0` = stand aside) and `FNR_GUARD_STATE_<SYMBOL>` every second so any custom EA in the same MT5 terminal can gate new entries with a single `GlobalVariableGet()` check and zero file or DLL overhead.
| |||
| |||
---
| |||
| |||
## Installation & Quick Integration
| |||
| |||
1. Copy `PropNewsSpreadGuard.mq5` into `MQL5/Experts/` and compile in MetaEditor (`0 errors, 0 warnings`).
| |||
2. Attach to any FX or metal chart (`Enable Algorithmic Trading` checked).
| |||
3. *(Optional)* Gate entries inside your own EA via the terminal RAM variable:
| |||
| |||
```mql5
| |||
string guardKey = "FNR_GUARD_SAFE_" + _Symbol;
| |||
if(GlobalVariableCheck(guardKey) && GlobalVariableGet(guardKey) < 0.5)
| |||
{
| |||
// Active Pre-News or Spread-Spike VETO — skip new entry
| |||
return;
| |||
}
| |||
```
| |||
| |||
---
| |||
| |||
## Author
| |||
| |||
* **MQL5 Profile:** [ForexNewsRadar](https://www.mql5.com/en/users/forexnewsradar)
|