# 🚀 VMM ARBITRAGE ELITE

## Professional Statistical Arbitrage Indicator

**VMM Arbitrage Elite** is a professional-grade statistical arbitrage indicator that identifies price discrepancies between correlated assets in real-time. Built for serious traders who demand precision and reliability.

---

## ⚡ KEY FEATURES

### 🔄 3 Trading Modes

Mode | Description |

**Auto-Correlation** | Automatically detects direct/inverse correlation between assets

**Triangulation (3 Assets)** | Advanced triangular arbitrage with manual reference selection

**Custom Manual** | Full control to select any reference and third asset

### 🎯 Smart Signal Generation

- **ATR-based dynamic triggers** - Adapts to market volatility

- **Configurable sensitivity** per symbol (Forex, Crypto, Commodities, JPY pairs)

- **Dead zone filter** eliminates noise and false signals

- **Min gap filter** ignores insignificant movements

### 📊 Real-Time Dashboard

- Live gap monitoring with directional arrows (▲/▼)

- ATR percentage and sensitivity multiplier display

- Correlation type indicator (DIRECT/INVERSE)

- Signal status with expiration timer

- Asset variation percentages

### 🔊 Smart Alert System

- **BUY signals** → Positive notification sound

- **SELL signals** → Negative notification sound

- Entry and exit alerts with cooldown protection

- Signal expiration (prevents stale signals)

- Minimum interval between signals for same asset

### 🔍 Multi-Timeframe Scanner

- Scan up to 6 pairs simultaneously

- 3 configurable timeframes with weighted opportunity calculation

- Real-time opportunity ranking

- Visual color coding by opportunity strength

- One-click toggle between scanner and normal mode

### 💾 Persistent State

- Remembers manual mode per asset

- Survives cTrader restarts and template reloads

- Automatic reset when changing assets

---

## 🎛️ COMPLETE PARAMETER REFERENCE

### ALGORITHM Parameters

Parameter | Type | Default | Description

Reference TF | TimeFrame | Daily | Base timeframe for price reference

Price Reference | Enum | Previous Close | Previous Close or Current Open

ATR Period | int | 14 | Period for Average True Range calculation

Base Sensitivity | double | 0.5 | 0.5 = 50% of ATR. Entry trigger multiplier

Exit % (Take Profit) | double | 0.2 | 0.2 = 20% of trigger value

Dead Zone | double | 0.005 | 0.005 = 0.5%. Noise filter

Min Gap Ignore | double | 0.001 | Ignore gaps below this value

Decimal Places | int | 2 | Display precision for percentages

### DICTIONARY Parameters

Parameter | Type | Default | Description

USD List | string | USD,XAU,GOLD,USDX | Symbols belonging to USD group

Euro List | string | EUR,EURX | Symbols belonging to EUR group

Yen List | string | JPY,JPYX | Symbols belonging to JPY group

Crypto List | string | BTC,ETH | Symbols belonging to Crypto group

USDX Name | string | USDX | Synthetic USD index symbol name

EURX Name | string | EURX | Synthetic EUR index symbol name

JPYX Name | string | JPYX | Synthetic JPY index symbol name

### ADVANCED Parameters

Parameter | Type | Default | Description

Custom Sensitivity | string | XAUUSD=0.03,XAGUSD=0.03,BTCUSD=0.35,ETHUSD=0.35,GBPJPY=0.15 | Per-symbol sensitivity (format: SYMBOL=value)

Forced Correlation | string | XAUUSD,USDX,INVERSE;XAGUSD,USDX,INVERSE | Force correlation type (format: SYMBOL,REF,TYPE)

### INTERFACE Parameters

Parameter | Type | Default | Description

Position | Enum | TopRight | Panel position on chart

Border Offset | int | 15 | Distance from chart edge (0-200)

Blink Signal | bool | true | Blink signal text when active

### ALERTS Parameters

Parameter | Type | Default | Description

Alerts | bool | true | Master switch for all alerts

Alert Entry | bool | true | Notify when entry trigger is hit

Alert Exit | bool | true | Notify when take profit target is hit

Cooldown (sec) | int | 60 | Minimum time between same alert type

Expire Signal (sec) | int | 300 | Maximum time signal stays active

Min Between Signals (sec) | int | 600 | Cooldown between signals for same asset

### SCANNER Parameters

Parameter | Type | Default | Description

Scanner Mode | bool | false | Enable scanner view

Pairs to Scan | string | EURUSD,GBPUSD,USDJPY,AUDUSD,USDCAD,USDCHF,NZDUSD | Comma-separated pair list

Multi Timeframes | bool | false | Enable multi-TF analysis

TF1 | TimeFrame | Hour | First timeframe (20% weight)

TF2 | TimeFrame | Hour4 | Second timeframe (30% weight)

TF3 | TimeFrame | Daily | Third timeframe (50% weight)

Min Opportunity | double | 0.02 | Minimum gap to display (0.02 = 2%)

Max Pairs to Show | int | 6 | Maximum rows in scanner table

### DEBUG Parameters

Parameter | Type | Default | Description

Debug Mode | bool | false | Show cache performance and debug notifications

Max Cache Size | int | 100 | Maximum cached symbols and bars

---

## 📈 HOW IT WORKS

### Gap Calculation

**Direct Correlation:** `Gap = Base Variation - Reference Variation`

**Inverse Correlation:** `Gap = Base Variation + Reference Variation`

**Triangulation:** `Gap = Base Variation - (Ref Variation + Tri Variation)`

### Entry Conditions

- **BUY Signal:** Gap ≤ -Trigger value

- **SELL Signal:** Gap ≥ +Trigger value

### Exit Conditions

- Signal expires after X seconds

- Gap returns to exit threshold (Take Profit)

- Market stalls (no gap change for 30 cycles)

---

## 🎯 USE CASES

Market | Recommended Sensitivity

Forex Majors | 0.25 - 0.50

Forex JPY Pairs | 0.10 - 0.20

Gold / Silver | 0.20 - 0.30

Cryptocurrencies | 0.30 - 0.50

Indices | 0.15 - 0.30

---

## 💡 TIPS FOR BEST RESULTS

1. **Start with Auto-Correlation mode** - Let the indicator learn pair relationships

2. **Use Daily reference TF** - More reliable for arbitrage detection

3. **Adjust sensitivity based on volatility** - Lower for calm markets, higher for volatile

4. **Enable scanner mode** - Quickly identify best opportunities across pairs

5. **Combine with manual analysis** - Always verify correlation during news events

⚠️ Legal Notice

The signals generated are suggestions based on mathematical algorithms, NOT investment recommendations. Trading involves significant risk of loss. Each trader is responsible for their own decisions. Always use proper risk management and test on demo accounts before trading with real money.