- AGENTS.md: Technical context for AI assistants - QUICKREF.md: Quick reference card - README.md: Updated with version history and performance - conversation-history/README.md: Updated session index - 2026-03-30-weekend-gap-short-signal-fix.md: Session notes
164 lines
4.5 KiB
Markdown
164 lines
4.5 KiB
Markdown
# 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*
|