# MQL Trading Bots Repository

Collection of MetaTrader 4/5 Expert Advisors and Indicators for automated forex trading.

## 🎯 Main Strategies

### 1. MultiSignal Confluence EA (PRIMARY)
Combines Pivot Points + Candlestick Patterns + Harmonic Patterns

```cpp
Signal Strength:
- 1 signal = 0.75 (NO TRADE)
- 2 signals = 0.90 (TRADE)
- 3 signals = 1.00 (STRONG TRADE)
```

### 2. OrdersEA_Smart_Grid EA
Grid trading around daily pivot levels with RSI/ADX filters

---

## 📁 File Structure

```
mql-trading-bots/
├── MultiSignal_Confluence_EA.mq5     # PRIMARY EA - Confluence trading (v1.14)
├── OrdersEA_Smart_Grid.mq5           # Grid trading EA (v3.1)
├── MultiSignal_Confluence.mq5        # Indicator version
├── HarmonicPatternFinderV2_Optimized.mq5
├── CandlestickPatternEA_Fixed.mq5
├── FadePivot2_v4_Fixed.mq5
├── confluence-*.set                   # Settings for Confluence EA (11 pairs)
├── grid-*.set                         # Settings for Grid EA (14 pairs)
└── verify-short-signals.py            # Verification script
```

---

## 📊 Performance

| Account | Period | Return | Win Rate | Status |
|---------|--------|--------|----------|--------|
| 104125640 | March 2026 | ~15-19% | 46-87% | Active |
| 103477358 | February 2026 | ~4% | - | Closed |

**Starting Balance:** $100,000  
**Current Balance:** ~$115,000+  
**Largest Win:** $8,091  
**Largest Loss:** -$805

---

## ⚙️ EA Versions

### MultiSignal_Confluence_EA.mq5
| Version | Date | Changes |
|---------|------|---------|
| v1.14 | 2026-03-30 | Fixed short signal detection (removed restrictive belowPivot check) |
| v1.13 | 2026-03-29 | Added daily drawdown protection |
| v1.12 | 2026-03-21 | Added volatility/ADX filters |
| v1.11 | 2026-03-21 | Fixed stop loss cross-symbol contamination |

### OrdersEA_Smart_Grid.mq5
| Version | Date | Changes |
|---------|------|---------|
| v3.1 | 2026-03-30 | Added weekend gap protection |
| v3.0 | 2026-03-29 | Fixed daily forced closure bug |

---

## 🚀 Deployment

### MT5 Location
```
~/mt5-docker/config/.wine/drive_c/Program Files/MetaTrader 5/MQL5/Experts/
```

### Deployment Steps
1. Copy `.mq5` files to MT5 `MQL5/Experts/`
2. Compile in MetaEditor (F7)
3. Attach to charts (H1 recommended)
4. Load corresponding `.set` file for each pair

### MT5 Docker
- **Location:** `~/mt5-docker/`
- **Config:** `mt5-docker/config/.wine/drive_c/Program Files/MetaTrader 5/`
- **Wine Version:** 9.17 (DO NOT upgrade to 10.0+)

---

## 🔧 Key Features

### Confluence EA Settings
```cpp
InpMinConfluence = 2       // Min signals to trade
InpMinStrength = 0.90     // Min signal strength
InpUseVolatilityFilter = true   // ATR filter
InpUseADXFilter = true     // ADX filter
InpMaxDailyDrawdown = 3.0 // Daily loss limit %
```

### Grid EA Settings
```cpp
UseAutoPivots = true       // Auto-calculate daily pivots
InpCloseBeforeWeekend = true  // Close Friday before weekend
InpWeekendCloseHour = 17   // 5 PM broker time
MaxLevels = 10             // Grid levels
```

---

## ⚠️ Known Issues & Solutions

| Issue | Solution | Version |
|-------|----------|---------|
| Stop loss cross-symbol contamination | Use `_Symbol` directly instead of CSymbolInfo | v1.11 |
| Short signals not firing | Removed `belowPivot` restriction | v1.14 |
| Weekend gap risk | Added Friday close option | v3.1 |
| Daily drawdown | Added `CheckDailyDrawdown()` protection | v1.13/v3.0 |

---

## 📈 Recommended Pair Setups

### Conservative (7 charts)
- USDJPY, EURJPY, EURUSD, AUDUSD, USDCAD (Confluence)
- EURCHF, EURUSD (Grid)

### Aggressive (12 charts)
Add: GBPUSD, NZDUSD, USDCHF (Confluence) + GBPUSD, USDJPY (Grid)

### Full Portfolio (15 charts)
Add: GBPJPY, XAUUSD (both EAs)

---

## 🔑 Important Notes

1. **Symbol-specific positions** - EAs track positions per `_Symbol`
2. **Magic Number** - Confluence: 777777, Grid: 333
3. **Only LONG trades** - Confluence EA was biased long (v1.13), fixed in v1.14
4. **Weekend risk** - Always enable `InpCloseBeforeWeekend=true`
5. **Daily DD** - Set `InpMaxDailyDrawdown=3.0` to limit losses

---

## 📂 Conversation History

See `conversation-history/` directory for session notes:
- `2026-03-21-mql-trading-bots.md` - Initial verification & migration
- `2026-03-29-session-save.md` - Settings library & bug fixes
- `2026-03-30-weekend-gap-short-signal-fix.md` - Weekend protection & short signal fix

---

## 🔗 Links

- **Gitea:** https://git.fetcherpay.com/garfield/mql-trading-bots
- **MT5 Reports:** `~/mt5-docker/config/.wine/drive_c/users/abc/Desktop/ReportHistory-*.html`

---

*Last Updated: 2026-03-30*