

## ๐ 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*