ForexSyncScalpEngine

### Short Description (max 63 chars)
Currency Strength Sync Engine — Multi-Pair Correlation Scalper

### Full Description

**ForexSyncScalpEngine** is a real-time currency strength analyzer that detects synchronized movements across multiple forex pairs to identify high-probability scalping opportunities.

**The Core Idea:**
When EUR/USD, EUR/GBP, EUR/CHF, EUR/JPY, EUR/CAD, EUR/AUD and EUR/NZD all move in the same direction simultaneously, the Euro is genuinely strong (or weak). This is not a coincidence — it's institutional money flow. The indicator captures these moments and generates precise entry signals.

**How It Works:**
The indicator automatically detects the base currency from your chart symbol. Open a EURUSD chart → it loads all EUR pairs. Open GBPUSD → it loads all GBP pairs. No manual configuration needed. It works for EUR, GBP, USD, AUD, CAD, CHF, JPY and NZD.

**Inverted Pair Logic:**
When analyzing GBP strength, the indicator loads EURGBP as an inverted pair. If EURGBP falls, GBP is getting stronger — the engine handles this automatically with correct directional mapping.

**Two Signal Types:**

1. **SYNC Signal** — Fires when a configurable percentage of correlated pairs (default 60%+) show the same direction. Higher sync = stronger signal. 100% sync highlights the bar with a special color. Volume confirmation adds extra strength rating.

2. **ABSORB Signal** — Detects exhaustion patterns. After 2+ consecutive bullish bars, a large upper wick (60%+ of bar range) signals selling absorption → potential reversal. Also detects doji exhaustion after 3+ trend bars.

**Live Dashboard:**
- All correlated pairs with direction arrows and % change
- Volume bars showing relative volume vs 20-bar average
- SYNC percentage bar with color coding (green 80%+, orange 50%+, red below)
- Bull/Bear count display
- Currency strength indicator (STRONG / WEAK / NEUTRAL)
- Micro trend analysis
- Scalable, repositionable (Top Right, Top Left, Bottom Right, Bottom Left)
- Auto-updating every 500ms via timer

**Signal Visualization:**
- Colored arrows (green = long, red = short)
- Star rating ★★★★★ (1-5 stars based on signal quality)
- Signal type labels (SYNC, ABSORB)
- Dashed SL/TP lines on chart
- Confirmed signals (matching micro-trend) shown in brighter colors

**Smart Features:**
- Automatic broker symbol detection (works with EURUSD, EURUSDm, EURUSD.pro etc.)
- Configurable TP/SL in points
- Fixed or dynamic SL (based on bar high/low)
- Audio alerts with separate sounds for Long/Short
- Maximum visible signals limit to keep chart clean
- Signal age expiration

**Best Used On:**
- M5 to H1 timeframes
- Major and cross pairs
- London and New York sessions (highest correlation)
- Works on any forex pair — the engine adapts automatically

**Input Parameters:**
- Trading: TP, SL, Min Sync %, Min Signal Strength, Max Signal Age
- Setups: Doji Threshold, Absorption Wick %, Volume Multiplier
- Pairs: Enable/disable individual pairs
- Display: Dashboard position, scale, arrows, stars, labels, SL/TP lines
- Alerts: Enable/disable, custom sound files

**Requirements:**
- MetaTrader 5
- Forex broker with standard pair naming
- Recommended: Add correlated pairs to Market Watch for faster data loading

---