## 🎯 **Project Overview**
I need an **Expert Advisor (EA)** for **MetaTrader 4** that combines signals from a **VWAP indicator** (provided) with **RSI Divergence detection** and includes a **Martingale function** for averaging losing positions. The EA should execute trades when **BOTH** indicators confirm the same direction.
---
## 📊 **Indicators Used**
### 1. VWAP Indicator (Custom)
- **File:** `VWAP_MT4_Gold_Ultimate 2d.mq4` (provided)
- **Buffer Structure:**
- Buffer 0: VWAP Line
- Buffer 1: Upper Band
- Buffer 2: Lower Band
- Buffer 3: Buy Arrows (`0.0` = no signal, `>0.0` = arrow)
- Buffer 4: Sell Arrows (`0.0` = no signal, `>0.0` = arrow)
### 2. RSI Divergence (Standard RSI)
- **Type:** Built-in `iRSI()` indicator
- **Divergence Types Required:**
- **Regular Bullish:** Price makes lower low, RSI makes higher low
- **Regular Bearish:** Price makes higher high, RSI makes lower high
- **Hidden Divergences** (optional)
- **Detection:** Swing high/low pivots in RSI
### 3. Divergence Strength Calculation
The EA calculates a divergence strength score from 0 to 100 based on the following factors:
- **Price swing size (20% weight):** The magnitude of the price movement between the two pivot points, normalized by ATR
- **RSI swing size (20% weight):** The magnitude of the RSI movement between the two pivot points
- **Divergence difference (40% weight):** The difference between price and RSI movement directions
- **Trend strength (10% weight):** Based on ADX value
- **RSI context (10% weight):** Bonus if RSI is in overbought/oversold territory
A divergence is considered valid only when its calculated strength is greater than or equal to `MinDivergenceStrength`.
---
## 📈 **Entry Logic**
### Signal Timing: `SignalAtBarClose = true`
- **All signals are evaluated at bar close** (prevents repainting). If set to false, signals are evaluated immediately, which may cause repainting and unreliable backtest results. Use with caution.
### First Entry Signal
A **first trade** is opened when **BOTH** conditions are met on the **same bar**:
#### BUY Signal (LONG)
1. **VWAP:** Green BUY arrow appears (Buffer 3 > 0)
2. **RSI:** Bullish divergence detected
#### SELL Signal (SHORT)
1. **VWAP:** Red SELL arrow appears (Buffer 4 > 0)
2. **RSI:** Bearish divergence detected
---
## 📊 **Martingale Function**
### Concept
When a trade (BUY or SELL) is in loss, **additional trades in the same direction** are opened to improve the average entry price.
### Martingale Entry Conditions
Each Martingale trade requires **TWO conditions**:
1. **Pip Distance:** Price has moved `MartingalePipStep` pips against the position
2. **Signal Confirmation:** One of three modes (user-selectable)
### Martingale Signal Modes
| Mode | Description | Buy Signal | Sell Signal |
|------|-------------|------------|-------------|
| **0** | **Pips Only** | Pip step reached | Pip step reached |
| **1** | **Pips + VWAP Band** | Pip step reached AND price at lower VWAP band | Pip step reached AND price at upper VWAP band |
| **2** | **Pips + RSI Level** | Pip step reached AND RSI < Oversold Level | Pip step reached AND RSI > Overbought Level |
### Martingale Exit Logic
When the **weighted net profit of all open trades in the same direction** reaches `MartingaleMinProfitPips` pips:
- **ALL trades in that direction are closed immediately**
The weighted net profit is calculated as the sum of (pips profit or loss × lot size) for each individual trade. This ensures that larger positions have a greater impact on the closing decision, reflecting the true monetary profit or loss of the combined positions.
### Example (BUY):
```
InitialLotSize = 0.01
MartingaleMultiplier = 1.5
MartingalePipStep = 50
MartingaleMaxTrades = 3
MartingaleMinProfitPips = 20
Trade 1 Buy: 0.01 @ 1.2000
→ Martingale triggered at 1.1950 (-50 pips)
Trade 2 Buy: 0.015 @ 1.1950
→ Martingale triggered at 1.1900 (-50 pips)
Trade 3 Buy: 0.0225 @ 1.1900
At 1.1960:
- Trade 1: -40 pips × 0.01 = -0.4
- Trade 2: +10 pips × 0.015 = +0.15
- Trade 3: +60 pips × 0.0225 = +1.35
- Net = +1.10 (≈ 20 pips profit in weighted terms)
→ ALL trades close at 1.1960!
```
---
## ⚙️ **Full Parameter List**
### 1. VWAP Settings
| Parameter | Description | Default |
|-----------|-------------|---------|
| `VWAP_ResetPeriod` | Reset period (0=H1,1=H4,2=Daily,3=Weekly,4=Monthly) | 2 |
| `VWAP_StdDevDist` | Band distance in standard deviations | 2.0 |
| `VWAP_ArrowOffset` | Arrow offset in points | 150 |
| `VWAP_UseRealVolume` | Use real volume if available | false |
### 2. RSI Settings
| Parameter | Description | Default |
|-----------|-------------|---------|
| `RSI_Period` | RSI period | 14 |
| `RSI_Overbought` | Overbought level | 70 |
| `RSI_Oversold` | Oversold level | 30 |
| `PivotStrength` | Pivot detection strength (bars left/right) | 2 |
| `MinPivotDistance` | Minimum distance between pivots in bars | 5 |
### 3. Divergence Settings
| Parameter | Description | Default |
|-----------|-------------|---------|
| `EnableRegularDivergence` | Enable regular divergence detection | true |
| `EnableHiddenDivergence` | Enable hidden divergence detection | false |
| `MinDivergenceStrength` | Minimum divergence strength (0-100). Only divergences with a strength >= this value are considered valid signals. | 50 |
### 4. Signal Settings
| Parameter | Description | Default |
|-----------|-------------|---------|
| `SignalAtBarClose` | Evaluate signals at bar close (recommended to prevent repainting) | true |
| `SignalTimeframe` | Timeframe for signal detection | PERIOD_H4 |
| `TradeTimeframe` | Timeframe for trade execution | PERIOD_H4 |
### 5. Lot Size Settings
| Parameter | Description | Default |
|-----------|-------------|---------|
| `InitialLotSize` | Initial lot size for first trade | 0.01 |
### 6. Martingale Settings
| Parameter | Description | Default |
|-----------|-------------|---------|
| `MartingaleEnabled` | Enable Martingale | false |
| `MartingaleMaxTrades` | Maximum number of Martingale trades per direction | 3 |
| `MartingalePipStep` | Pip distance between Martingale trades | 50 |
| `MartingaleMultiplier` | Lot multiplier per step | 1.5 |
| `MartingaleMinProfitPips` | Minimum profit in pips to close all trades | 20 |
| `MartingaleRequiresSignal` | Martingale trade requires signal confirmation | true |
| `MartingaleSignalMode` | Signal mode (0=Pips only, 1=Pips+VWAP, 2=Pips+RSI) | 1 |
| `MartingaleMaxTotalLossPips` | Maximum loss in pips for Martingale positions | 200 |
### 7. Order Management Settings
| Parameter | Description | Default |
|-----------|-------------|---------|
| `StopLossPips` | Stop loss in pips | 50 |
| `TakeProfitPips` | Take profit in pips | 100 |
| `TrailingStopPips` | Trailing stop in pips (0 = disabled) | 0 |
| `OrderComment` | Order comment | "VWAP Divergence" |
| `MagicNumber` | Unique Magic Number | 20260817 |
### 8. Safety Settings
| Parameter | Description | Default |
|-----------|-------------|---------|
| `MaxSpread` | Maximum spread in points | 30 |
| `MaxSlippage` | Maximum slippage in points | 10 |
| `MaxTotalLoss` | Maximum total loss in account currency (EA STOPS COMPLETELY) | 500 |
| `MaxTradesPerDirection` | Maximum open trades per direction (excluding Martingale) | 1 |
### 9. Display Settings
| Parameter | Description | Default |
|-----------|-------------|---------|
| `ShowDivergenceLines` | Draw divergence lines on chart | true |
| `ShowSignalArrows` | Draw signal arrows on chart | true |
| `ShowInfoPanel` | Show info panel on chart | true |
---
## 🛠️ **Technical Requirements**
### Platform
- **MetaTrader 4 ONLY** (not MT5)
- Compatible with Windows 10/11
### Performance & Stability
- **NO repainting** of signals
- Use `iCustom()` to read VWAP indicator signals
- All parameters must be **optimizable** in Strategy Tester
- **Error handling** with `GetLastError()`
- **Logging** in Experts tab
- The EA must be stable and must not freeze MT4 even during periods of high volatility or when processing many historical bars. The developer should review the VWAP indicator code to ensure it runs efficiently without changing its layout or functionality.
### Code Quality
- **Modular structure:**
- Signal Engine (VWAP + RSI)
- Divergence Engine (Pivot detection)
- Trade Manager (Order open/close)
- Martingale Manager
- Risk Manager (MaxLoss monitoring)
- `#property strict` required
- Well-commented code
-
The EA must be stable and must not freeze MT4 even during periods of high volatility or when processing many historical bars
-
The developer is expected to review and optimize the VWAP indicator code for performance without changing its layout or functionality. The indicator currently uses nested loops which may cause performance issues with large history. The developer should implement necessary optimizations to ensure smooth operation while preserving the indicator's visual appearance and signal logic.
-
The EA is primarily designed for XAUUSD (Gold)
-
All pip calculations, stop loss, take profit, Martingale steps, and profit targets must work correctly for XAUUSD
-
XAUUSD has a specific pip value (0.01 for 5-digit brokers) and the EA must handle this correctly
-
All parameters related to pips (StopLossPips, TakeProfitPips, MartingalePipStep, MartingaleMinProfitPips, MartingaleMaxTotalLossPips) must be calculated and applied correctly for this instrument
-
The developer must ensure that Point and pip calculations are properly handled for XAUUSD's decimal places
---
## 🛑 **Safety Features**
| Feature | Description |
|---------|-------------|
| **MaxTotalLoss** | If total loss reaches this amount, EA **STOPS ALL TRADING** permanently (until manually reactivated) |
| **MartingaleMaxTotalLossPips** | If Martingale positions reach this loss in pips, all Martingale trades close (EA continues trading) |
**No restrictions:** No `MaxTradesPerDay` restriction. No "only one position per direction" restriction beyond standard Martingale logic (Martingale requires multiple positions).
---
## 📦 **Delivery Requirements**
1. **Source Code:** `.mq4` file
2. **Compiled File:** `.ex4` file
3. **Parameter Set:** Optimized `.set` file
4. **User Guide:** PDF with all parameters explained (in English)
5. **Bugfix Support:** 14 days after delivery
6. **Installation Instructions:** Step-by-step guide
---
## 🔧 **Sample Logic (Pseudocode)**
```mql4
// MARTINGALE SIGNAL LOGIC
if (MartingaleRequiresSignal) {
switch (MartingaleSignalMode) {
case 0: // Pips Only
martingaleSignal = true;
break;
case 1: // Pips + VWAP Band
if (direction == BUY) {
martingaleSignal = (close[i] <= VWAP_LowerBand[i]);
} else {
martingaleSignal = (close[i] >= VWAP_UpperBand[i]);
}
break;
case 2: // Pips + RSI Level
if (direction == BUY) {
martingaleSignal = (RSI[i] < RSI_Oversold);
} else {
martingaleSignal = (RSI[i] > RSI_Overbought);
}
break;
}
} else {
martingaleSignal = true;
}
// ENTRY CONDITIONS
if (MartingaleEnabled && IsLossPosition() && martingaleSignal) {
OpenMartingaleTrade();
}
```
---
## 📝 **Summary of Martingale Modes**
| Mode | Description | Best For |
|------|-------------|----------|
| **0** | Pips only | Aggressive traders, fast averaging |
| **1** | Pips + VWAP Band | Conservative traders, institutional support/resistance |
| **2** | Pips + RSI Level | Traders who want oversold/overbought confirmation |
---
## 💰 **Budget & Timeline**
- **Budget:** Please provide your quote
- **Timeline:** 2-7 days expected
- **Payment:** MQL5 escrow terms
---
## 📧 **Application Requirements**
Please include in your proposal:
1. **Estimated timeline** and delivery date
2. **Your experience** with Martingale EAs and divergence detection in MT4
3. **Confirmation** that you work with MT4 (not MT5)
4. **Any questions** or clarifications needed
5. **Examples** of similar EAs you have developed
---
## 📎 **Attachment**
- `VWAP_MT4_Gold_Ultimate 2d.mq4` (provided)
---
**Ready to hire!** 🚀
**Platform:** MetaTrader 4 ONLY
**Budget:** Open to negotiation