

## 📋 Table of Contents 1. [Overview](#overview) 2. [Core Features](#core-features) 3. [Parameter Configuration](#parameter-configuration) 4. [Consecutive Loss Protection System](#consecutive-loss-protection-system) 5. [News Filter System](#news-filter-system) 6. [Session and Day Management](#session-and-day-management) 7. [Advanced Risk Management](#advanced-risk-management) 8. [Trading Modes](#trading-modes) 9. [Monitoring and Display](#monitoring-and-display) 10. [Troubleshooting](#troubleshooting) 11. [FAQ](#faq) --- ## 🎯 Overview Matrix Gold Resurrection is an advanced automated trading system specifically designed for XAUUSD (Gold) trading. The bot features multi-timeframe analysis, multiple signal confirmations, and sophisticated risk protection systems. ### Key Features - **8 Independent Signal Confirmation Systems** - **Advanced Consecutive Loss Protection** with 3 action modes - **Automatic News Filter** with pre/post event management - **Enhanced Session Management** with open position control - **Weekly Schedule Programming** - **Automatic Trade Timeout** (max trade duration) - **Dynamic Risk Management** with compound growth --- ## 🔧 Core Features ### 1. **Consecutive Loss Protection System** ``` Problem Solved: Bot continuing to lose without stopping ``` - ✅ **Automatic Detection**: Real-time consecutive loss counting - ✅ **3 Management Modes**: - `StopAndWaitCooldown`: Stop + wait fixed time - `StopAndWaitTrendReverse`: Stop + wait for SMA trend reversal - `ContinueWithReducedRisk`: Continue with reduced volume - ✅ **Position Close Option**: Closes all open positions when triggered ### 2. **Advanced News Filter** ``` Problem Solved: Trading during high-impact events ``` - ✅ **Automatic Detection**: Identifies high-risk time windows - ✅ **Pre/Post News Control**: Configurable 5-120 minutes - ✅ **3 Actions for Open Positions**: - `KeepOpen`: Maintains active positions - `Pause`: Temporarily removes SL/TP - `CloseAll`: Closes all positions ### 3. **Trade Timeout Management** ``` Problem Solved: Positions staying open too long ``` - ✅ **Configurable Max Duration**: Default 30 minutes (5-480 min) - ✅ **Automatic Closure**: When timeout is reached - ✅ **Precise Tracking**: Monitors each individual position ### 4. **Weekly Programming** ``` Problem Solved: Trading on non-optimal days ``` - ✅ **Weekly Day Control**: Monday-Friday configurable - ✅ **Safe Default**: Friday disabled (high volatility) - ✅ **Automatic Weekend**: Saturday/Sunday always disabled ### 5. **Enhanced Dynamic SL** ``` Problem Solved: Fixed SL not suitable for volatility ``` - ✅ **Real-time Calculation**: Based on volatility and confirmations - ✅ **Minimum Protection**: 20 pips minimum SL for very low risk - ✅ **Intelligent Scaling**: Adapts to market conditions --- ## ⚙️ Parameter Configuration ### **TRADING MODE** ``` Parameter: Trading Mode Options: Aggressive | Balanced | Conservative Recommendation: Balanced for beginners ``` ### **🛡️ CONSECUTIVE LOSS PROTECTION** ``` Max Consecutive Losses: 2-10 (Recommended: 3) Consecutive Loss Action: - StopAndWaitCooldown (Recommended) - StopAndWaitTrendReverse - ContinueWithReducedRisk Consecutive Loss Cooldown: 15-480 min (Recommended: 60) Stop All On Consecutive Loss: true/false ``` **Recommended Configurations:** - **Conservative**: Max 2 losses, 90 min cooldown, StopAll=true - **Balanced**: Max 3 losses, 60 min cooldown, StopAll=false - **Aggressive**: Max 4 losses, 30 min cooldown, ContinueWithReducedRisk ### **📰 NEWS FILTER** ``` Pre-News Stop Trading: 30 min (Recommended) Post-News Stop Trading: 15 min (Recommended) News Position Action: - KeepOpen: High risk - Pause: Balanced (Recommended) - CloseAll: Conservative ``` ### **📅 WEEKLY PROGRAMMING** ``` Trade on Monday: true Trade on Tuesday: true Trade on Wednesday: true Trade on Thursday: true Trade on Friday: false (Recommended - High volatility) ``` ### **⏱️ TIMEOUT MANAGEMENT** ``` Max Trade Duration: 30 min (5-480 min) ``` **Timeframe Recommendations:** - Scalping (M1-M5): 15-30 min - Intraday (M15-H1): 60-120 min - Swing: 240+ min ### **🕐 TRADING SESSIONS** ``` EU Session Start: 1 (01:00 GMT) US Session End: 21 (21:00 GMT) Session Position Action: - KeepOpen: Maintains positions - Pause: Pause management (Recommended) - CloseAll: Closes everything ``` --- ## 🛡️ Consecutive Loss Protection System ### **How It Works** 1. **Detection**: ``` ✅ Each closed losing position increments counter ✅ Each profitable position resets counter ✅ Real-time monitoring ``` 2. **Actions When Triggered**: **StopAndWaitCooldown** (Recommended): ``` - Immediate stop of new operations - Wait configurable cooldown period - Optional: Close open positions - Automatic reset after cooldown ``` **StopAndWaitTrendReverse**: ``` - Immediate stop of new operations - SMA trend monitoring for reversal - Automatic resume on trend change - More sophisticated but less predictable ``` **ContinueWithReducedRisk**: ``` - Continue operations with reduced volume - Progressive reduction: -15% per loss - Minimum 30% of original volume - Reset on first profitable operation ``` ### **Protection Status Display** The bot always shows current status: ``` 📉 Consecutive Loss (2/3): 🟢 OK - Cooldown 📉 Consecutive Loss (3/3): 🚨 ACTIVE - Cooldown 📉 Consecutive Loss (4/5): 🚨 ACTIVE - TrendReverse ``` --- ## 📰 News Filter System ### **Automatic News Times** (GMT) The bot automatically detects: ``` 08:30 - EUR News (Inflation, GDP, etc.) 12:30 - USD News (NFP, CPI, etc.) 14:00 - FOMC/Fed Decisions 15:30 - US Market Opening (volatility) ``` ### **Block Windows** ``` Pre-News: 30 minutes before (configurable) During: Event in progress Post-News: 15 minutes after (configurable) ``` ### **Position Management During News** **KeepOpen**: ``` ✅ Pro: Maintains potentially profitable positions ❌ Con: High risk on gaps/spikes ``` **Pause** (Recommended): ``` ✅ Pro: Protects from volatile movements ✅ Pro: Automatically resumes after news ⚠️ Note: Temporarily removes SL/TP ``` **CloseAll**: ``` ✅ Pro: Maximum protection ❌ Con: May close profitable trades prematurely ``` --- ## 🕐 Session and Day Management ### **Trading Sessions** ``` European Session: 01:00-21:00 GMT (Default) - London Opening: Medium volatility - EU-US Overlap: High volatility (Recommended) ``` ### **Days of the Week** ``` ✅ Monday: OK (Market resumption) ✅ Tuesday: Excellent (Consolidated trends) ✅ Wednesday: Excellent (Stability) ✅ Thursday: Good (Pre-weekend) ❌ Friday: Not recommended (Weekly closures) ❌ Weekend: Always disabled ``` ### **Behavior Outside Session** When trading is disabled for session/day: **For New Operations:** - ❌ No signal analysis - ❌ No position opening **For Open Positions:** - `KeepOpen`: No changes - `Pause`: Temporarily removes SL/TP - `CloseAll`: Closes all positions --- ## 💰 Advanced Risk Management ### **Base Volume and Compound Growth** ``` Base Volume: 0.01-10 lots Enable Compound Growth: true/false Compound Growth Rate: 0.5-100% (Recommended: 2%) ``` **Compound Growth Formula:** ``` New Volume = Base Volume × (1 + ((Equity/StartBalance - 1) × Growth Rate%)) ``` **Example:** ``` Start Balance: $10,000 Current Equity: $11,000 (+10%) Growth Rate: 2% Effective Growth: 10% × 2% = 0.2% New Volume: 0.01 × 1.002 = 0.01002 lots ``` ### **Dynamic Risk** ``` Use Dynamic Risk: true/false Max Position Risk: 0.001-25% (Recommended: 0.5%) ``` **With Dynamic Risk Active:** 1. Calculate risk per trade: `Balance × Risk%` 2. Calculate volume: `Risk Amount ÷ (SL × Pip Value)` 3. Apply safety limitations 4. Reduce for consecutive losses (if enabled) ### **Volume Protections** ``` ✅ Minimum Volume: Always respected ✅ Maximum Volume: 3× base volume ✅ Circuit Breaker Reduction: -50% ✅ Consecutive Loss Reduction: -15% per loss ``` --- ## 🎮 Trading Modes ### **Aggressive Mode** ``` ✅ Fast Timeframes: M2/M45 ✅ Min Confirmations: 2 ✅ Max Positions: 10 ✅ Trade Interval: 3 min ✅ Risk: 0.05% (Very low but frequent) ``` **Suitable for**: Large accounts, high experience, active monitoring ### **Balanced Mode** (Recommended) ``` ✅ Medium Timeframes: M3/M30 ✅ Min Confirmations: 2 ✅ Max Positions: 2 ✅ Trade Interval: 6 min ✅ Risk: 1.5% ``` **Suitable for**: Most users, good balance ### **Conservative Mode** ``` ✅ Slow Timeframes: M5/H1 ✅ Min Confirmations: 3 ✅ Max Positions: 1 ✅ Trade Interval: 12 min ✅ Risk: 1.2% ``` **Suitable for**: Beginners, small accounts, maximum safety --- ## 📊 Monitoring and Display ### **Main Panel** ``` ═══ MATRIX GOLD RESURRECTION v1.0 ═══ 💼 Balanced | 🟢 ACTIVE | 🟢 READY | 🟢 ALLOWED 🎯 $2650.50 | 📊 3.2pips | 📈 45.5pips 🟢 BULL | 📊 RSI:58 | ⚡ 0.025 💹 PERFORMANCE Trades: 15 | Win: 73.3% | P&L: $285.50 Max DD: 2.1% | Equity: $10,285.50 Positions: 1/2 🛡️ PROTECTION STATUS 📉 Consecutive Loss (1/3): 🟢 OK - Cooldown 📰 News Filter: 🟢 CLEAR ⚡ Circuit Breaker: 🟢 OK (3.0%) ``` ### **Status Codes** ``` 🟢 OK/ACTIVE/READY = Normal 🔴 BLOCKED/CLOSED = Disabled 🚨 ACTIVE = Protection active ⏳ COOLDOWN = Waiting in progress ⚫ OFF/NEUTRAL = Disabled/Neutral ``` ### **Important Log Messages** ``` ✅ Executed Operations 🛡️ Activated Protections 📰 News Events ⏱️ Operation Timeouts 🔄 Dynamic Updates ❌ Errors and Blocks ``` --- ## 🔧 Troubleshooting ### **Problem: Bot Not Opening Positions** **Checks in Order:** 1. ✅ **Allowed Day**: Check Trading Days 2. ✅ **Active Session**: Check EU/US hours 3. ✅ **Spread OK**: Must be < Max Spread 4. ✅ **Protections**: No active protection 5. ✅ **Confirmations**: Sufficient signals 6. ✅ **Volatility**: Within configured limits 7. ✅ **Max Positions**: Limit not reached **Logs to Look For:** ``` ❌ Matrix Gold: Trading not allowed on Friday ❌ Matrix Gold: Trading blocked by consecutive loss protection ❌ Matrix Gold: Trading blocked by news filter ⚠️ Matrix Gold signal too weak: 0.008 < 0.012 ``` ### **Problem: Too Many Consecutive Losses** **Solutions:** 1. **Reduce Max Consecutive Losses**: From 3 to 2 2. **Increase Cooldown**: From 60 to 90+ minutes 3. **Enable Stop All Positions**: true 4. **Change Mode**: From Aggressive to Conservative 5. **Increase Min Confirmations**: From 2 to 3+ ### **Problem: SL Too Small** **Causes and Solutions:** ``` Cause: Risk % too low (e.g. 0.01%) Solution: Increase to 0.1%+ or disable Dynamic Risk Cause: Volume too high for small account Solution: Reduce Base Volume Cause: Active protection Solution: Wait for protection reset ``` ### **Problem: Bot Ignores News** **Verifications:** ``` ✅ News Filter enabled in settings ✅ Check correct GMT hours ✅ Verify Pre/Post News settings ✅ Monitor logs for activation confirmation ``` --- ## ❓ FAQ ### **Q: What's the best configuration to start with?** **A:** ``` Mode: Balanced Max Consecutive Losses: 3 Cooldown: 60 min News Position Action: Pause Max Trade Duration: 30 min Risk: 1% max Compound Growth: OFF initially ``` ### **Q: Why does the bot stop frequently?** **A:** The bot has many protections. Check: - Consecutive losses reached - Active news events - Outside session/allowed day - Spread too high - Circuit breaker active ### **Q: How to optimize performance?** **A:** 1. **Backtesting**: Test different configurations 2. **Demo First**: Never live without testing 3. **Monitor Drawdown**: Never exceed 5-10% 4. **Adjust Gradually**: One parameter at a time 5. **Keep Logs**: For post-session analysis ### **Q: When to use different consecutive loss modes?** **A:** - **Cooldown**: Always safe, predictable - **Trend Reverse**: For experienced traders, less predictable - **Reduced Risk**: Stable markets, desire to continue ### **Q: How to manage compound growth?** **A:** ``` Start: OFF (test stability first) Rate: 1-2% max (gradual growth) Monitor: Check volume increments Stop: If drawdown increases ``` ### **Q: Can I trade other symbols besides XAUUSD?** **A:** The bot is optimized for gold. Other symbols require parameter modifications (SL, TP, volatility, S/R levels). ### **Q: How to interpret Trend Strength?** **A:** ``` 0.0-0.2: Weak trend (few signals) 0.2-0.5: Moderate trend 0.5-0.8: Strong trend (good signals) 0.8-1.0: Very strong trend (excellent signals) ``` --- ## 🎯 Bot Startup Checklist ### **Before Starting:** - [ ] Demo account tested for 1+ weeks - [ ] Parameters optimized for your style - [ ] Risk per trade under 2% - [ ] Consecutive loss protections configured - [ ] News filter enabled - [ ] Trading days appropriately selected - [ ] Max trade duration set - [ ] Display panels enabled for monitoring ### **Active Monitoring:** - [ ] Check logs every hour in first days - [ ] Verify protection activations - [ ] Monitor maximum drawdown - [ ] Observe consecutive loss patterns - [ ] Test news event management ### **Continuous Optimization:** - [ ] Analyze weekly performance - [ ] Adjust parameters gradually - [ ] Maintain detailed statistics - [ ] Backup working configurations --- **Matrix Gold Resurrection** - Safe and Professional Automated Trading *Developed for traders who prioritize capital protection*