## 📋 Indice 1. [Panoramica](#overview) 2. [Caratteristiche Principali](#core-features) 3. [Configurazione Parametri](#parameter-configuration) 4. [Sistema di Protezione dalle Perdite Consecutive](#consecutive-loss-protection-system) 5. [Sistema di Filtro Notizie](#news-filter-system) 6. [Gestione Sessioni e Giorni](#session-and-day-management) 7. [Gestione Avanzata del Rischio](#advanced-risk-management) 8. [Modalità di Trading](#trading-modes) 9. [Monitoraggio e Visualizzazione](#monitoring-and-display) 10. [Risoluzione Problemi](#troubleshooting) 11. [FAQ](#faq) --- ## 🎯 Panoramica Matrix Gold Resurrection è un sistema di trading automatizzato avanzato progettato specificamente per il trading su XAUUSD (Oro). Il bot offre analisi multi-timeframe, molteplici conferme di segnale e sofisticati sistemi di protezione del rischio. ### Caratteristiche Chiave - **8 Sistemi Indipendenti di Conferma Segnali** - **Protezione Avanzata dalle Perdite Consecutive** con 3 modalità operative - **Filtro Notizie Automatico** con gestione pre/post evento - **Gestione Sessioni Migliorata** con controllo delle posizioni aperte - **Programmazione Settimanale** - **Timeout Automatico delle Operazioni** (durata massima trade) - **Gestione Dinamica del Rischio** con crescita composta --- ## 🔧 Caratteristiche Principali ### 1. **Sistema di Protezione dalle Perdite Consecutive** ``` Problema Risolto: Bot che continua a perdere senza fermarsi ``` - ✅ **Rilevamento Automatico**: Conteggio in tempo reale delle perdite consecutive - ✅ **3 Modalità di Gestione**: - `StopAndWaitCooldown`: Ferma + attesa tempo fisso - `StopAndWaitTrendReverse`: Ferma + attesa inversione trend SMA - `ContinueWithReducedRisk`: Continua con volume ridotto - ✅ **Opzione Chiusura Posizioni**: Chiude tutte le posizioni aperte quando attivato ### 2. **Filtro Notizie Avanzato** ``` Problema Risolto: Trading durante eventi ad alto impatto ``` - ✅ **Rilevamento Automatico**: Identifica finestre temporali ad alto rischio - ✅ **Controllo Pre/Post Notizie**: Configurabile da 5 a 120 minuti - ✅ **3 Azioni per Posizioni Aperte**: - `KeepOpen`: Mantiene posizioni attive - `Pause`: Rimuove temporaneamente SL/TP - `CloseAll`: Chiude tutte le posizioni ### 3. **Gestione Timeout Operazioni** ``` Problema Risolto: Posizioni aperte troppo a lungo ``` - ✅ **Durata Massima Configurabile**: Default 30 minuti (5-480 min) - ✅ **Chiusura Automatica**: Al raggiungimento del timeout - ✅ **Monitoraggio Preciso**: Controlla ogni singola posizione ### 4. **Programmazione Settimanale** ``` Problema Risolto: Trading in giorni non ottimali ``` - ✅ **Controllo Giorni Settimanali**: Configurabile da lunedì a venerdì - ✅ **Default Sicuro**: Venerdì disabilitato (alta volatilità) - ✅ **Weekend Automatico**: Sabato/Domenica sempre disabilitati ### 5. **SL Dinamico Migliorato** ``` Problema Risolto: SL fisso non adatto alla volatilità ``` - ✅ **Calcolo in Tempo Reale**: Basato su volatilità e conferme - ✅ **Protezione Minima**: SL minimo di 20 pips per rischio molto basso - ✅ **Scala Intelligente**: Si adatta alle condizioni di mercato --- ## ⚙️ Configurazione Parametri ### **MODALITÀ DI TRADING** ``` Parametro: Modalità di Trading Opzioni: Aggressiva | Bilanciata | Conservativa Raccomandazione: Bilanciata per principianti ``` ### **🛡️ PROTEZIONE PERDITE CONSECUTIVE** ``` Perdite Consecutive Massime: 2-10 (Raccomandato: 3) Azione per Perdite Consecutive: - StopAndWaitCooldown (Raccomandato) - StopAndWaitTrendReverse - ContinueWithReducedRisk Cooldown Perdite Consecutive: 15-480 min (Raccomandato: 60) Ferma Tutto su Perdite Consecutive: true/false ``` **Configurazioni Raccomandate:** - **Conservativa**: Max 2 perdite, cooldown 90 min, StopAll=true - **Bilanciata**: Max 3 perdite, cooldown 60 min, StopAll=false - **Aggressiva**: Max 4 perdite, cooldown 30 min, ContinueWithReducedRisk ### **📰 FILTRO NOTIZIE** ``` Stop Trading Pre-Notizie: 30 min (Raccomandato) Stop Trading Post-Notizie: 15 min (Raccomandato) Azione Posizioni Notizie: - KeepOpen: Alto rischio - Pause: Bilanciato (Raccomandato) - CloseAll: Conservativo ``` ### **📅 PROGRAMMAZIONE SETTIMANALE** ``` Trading il Lunedì: true Trading il Martedì: true Trading il Mercoledì: true Trading il Giovedì: true Trading il Venerdì: false (Raccomandato - Alta volatilità) ``` ### **⏱️ GESTIONE TIMEOUT** ``` Durata Massima Trade: 30 min (5-480 min) ``` **Raccomandazioni Timeframe:** - Scalping (M1-M5): 15-30 min - Intraday (M15-H1): 60-120 min - Swing: 240+ min ### **🕐 SESSIONI DI TRADING** ``` Inizio Sessione EU: 1 (01:00 GMT) Fine Sessione US: 21 (21:00 GMT) Azione Posizione Sessione: - KeepOpen: Mantiene posizioni - Pause: Gestione pausa (Raccomandato) - CloseAll: Chiude tutto ``` --- ## 🛡️ Sistema di Protezione dalle Perdite Consecutive ### **Come Funziona** 1. **Rilevamento**: ``` ✅ Ogni posizione chiusa in perdita incrementa il contatore ✅ Ogni posizione profittevole resetta il contatore ✅ Monitoraggio in tempo reale ``` 2. **Azioni Quando Attivato**: **StopAndWaitCooldown** (Raccomandato): ``` - Stop immediato delle nuove operazioni - Attesa del periodo di cooldown configurabile - Opzionale: chiusura posizioni aperte - Reset automatico dopo cooldown ``` **StopAndWaitTrendReverse**: ``` - Stop immediato delle nuove operazioni - Monitoraggio inversione trend SMA - Ripresa automatica al cambio trend - Più sofisticato ma meno prevedibile ``` **ContinueWithReducedRisk**: ``` - Continua operazioni con volume ridotto - Riduzione progressiva: -15% per perdita - Minimo 30% del volume originale - Reset alla prima operazione profittevole ``` ### **Visualizzazione Stato Protezione** Il bot mostra sempre lo stato corrente: ``` 📉 Perdita Consecutiva (2/3): 🟢 OK - Cooldown 📉 Perdita Consecutiva (3/3): 🚨 ATTIVO - Cooldown 📉 Perdita Consecutiva (4/5): 🚨 ATTIVO - TrendReverse ``` --- ## 📰 Sistema di Filtro Notizie ### **Orari Notizie Automatici** (GMT) Il bot rileva automaticamente: ``` 08:30 - Notizie EUR (Inflazione, PIL, ecc.) 12:30 - Notizie USD (NFP, CPI, ecc.) 14:00 - Decisioni FOMC/Fed 15:30 - Apertura Mercato USA (volatilità) ``` ### **Finestre di Blocco** ``` Pre-Notizie: 30 minuti prima (configurabile) Durante: Evento in corso Post-Notizie: 15 minuti dopo (configurabile) ``` ### **Gestione Posizioni Durante le Notizie** **KeepOpen**: ``` ✅ Pro: Mantiene posizioni potenzialmente profittevoli ❌ Contro: Alto rischio su gap/picchi ``` **Pause** (Raccomandato): ``` ✅ Pro: Protegge da movimenti volatili ✅ Pro: Riprende automaticamente dopo le notizie ⚠️ Nota: Rimuove temporaneamente SL/TP ``` **CloseAll**: ``` ✅ Pro: Massima protezione ❌ Contro: Può chiudere trade profittevoli prematuramente ``` --- ## 🕐 Gestione Sessioni e Giorni ### **Sessioni di Trading** ``` Sessione Europea: 01:00-21:00 GMT (Default) - Apertura Londra: Volatilità media - Sovrapposizione EU-US: Alta volatilità (Raccomandato) ``` ### **Giorni della Settimana** ``` ✅ Lunedì: OK (Ripresa mercato) ✅ Martedì: Eccellente (Trend consolidati) ✅ Mercoledì: Eccellente (Stabilità) ✅ Giovedì: Buono (Pre-weekend) ❌ Venerdì: Non raccomandato (Chiusure settimanali) ❌ Weekend: Sempre disabilitato ``` ### **Comportamento Fuori Sessione** Quando il trading è disabilitato per sessione/giorno: **Per Nuove Operazioni:** - ❌ Nessuna analisi segnali - ❌ Nessuna apertura posizione **Per Posizioni Aperte:** - `KeepOpen`: Nessuna modifica - `Pause`: Rimuove temporaneamente SL/TP - `CloseAll`: Chiude tutte le posizioni --- ## 💰 Gestione Avanzata del Rischio ### **Volume Base e Crescita Composta** ``` Volume Base: 0.01-10 lotti Abilita Crescita Composta: true/false Tasso Crescita Composta: 0.5-100% (Raccomandato: 2%) ``` **Formula Crescita Composta:** ``` Nuovo Volume = Volume Base × (1 + ((Equity/StartBalance - 1) × Tasso Crescita%)) ``` **Esempio:** ``` Saldo Iniziale: $10,000 Equity Attuale: $11,000 (+10%) Tasso Crescita: 2% Crescita Effettiva: 10% × 2% = 0.2% Nuovo Volume: 0.01 × 1.002 = 0.01002 lotti ``` ### **Rischio Dinamico** ``` Usa Rischio Dinamico: true/false Rischio Massimo Posizione: 0.001-25% (Raccomandato: 0.5%) ``` **Con Rischio Dinamico Attivo:** 1. Calcola rischio per trade: `Balance × Risk%` 2. Calcola volume: `Importo Rischio ÷ (SL × Valore Pip)` 3. Applica limitazioni di sicurezza 4. Riduce per perdite consecutive (se abilitato) ### **Protezione Volume** ``` ✅ Volume Minimo: Sempre rispettato ✅ Volume Massimo: 3× volume base ✅ Riduzione Circuit Breaker: -50% ✅ Riduzione Perdite Consecutive: -15% per perdita ``` --- ## 🎮 Modalità di Trading ### **Modalità Aggressiva** ``` ✅ Timeframe Veloci: M2/M45 ✅ Conferme Minime: 2 ✅ Posizioni Massime: 10 ✅ Intervallo Trade: 3 min ✅ Rischio: 0.05% (Molto basso ma frequente) ``` **Adatto per**: Conti grandi, esperienza elevata, monitoraggio attivo ### **Modalità Bilanciata** (Raccomandata) ``` ✅ Timeframe Medi: M3/M30 ✅ Conferme Minime: 2 ✅ Posizioni Massime: 2 ✅ Intervallo Trade: 6 min ✅ Rischio: 1.5% ``` **Adatto per**: La maggior parte degli utenti, buon equilibrio ### **Modalità Conservativa** ``` ✅ Timeframe Lenti: M5/H1 ✅ Conferme Minime: 3 ✅ Posizioni Massime: 1 ✅ Intervallo Trade: 12 min ✅ Rischio: 1.2% ``` **Adatto per**: Principianti, conti piccoli, massima sicurezza --- ## 📊 Monitoraggio e Visualizzazione ### **Pannello Principale** ``` ═══ MATRIX GOLD RESURRECTION v1.0 ═══ 💼 Bilanciata | 🟢 ATTIVO | 🟢 PRONTO | 🟢 CONSENTITO 🎯 $2650.50 | 📊 3.2pips | 📈 45.5pips 🟢 BULL | 📊 RSI:58 | ⚡ 0.025 💹 PERFORMANCE Operazioni: 15 | Vittorie: 73.3% | P&L: $285.50 Max DD: 2.1% | Equity: $10,285.50 Posizioni: 1/2 🛡️ STATO PROTEZIONE 📉 Perdita Consecutiva (1/3): 🟢 OK - Cooldown 📰 Filtro Notizie: 🟢 LIBERO ⚡ Circuit Breaker: 🟢 OK (3.0%) ``` ### **Codici Stato** ``` 🟢 OK/ATTIVO/PRONTO = Normale 🔴 BLOCCATO/CHIUSO = Disabilitato 🚨 ATTIVO = Protezione attiva ⏳ COOLDOWN = Attesa in corso ⚫ OFF/NEUTRALE = Disabilitato/Neutro ``` ### **Messaggi Log Importanti** ``` ✅ Operazioni Eseguite 🛡️ Protezioni Attivate 📰 Eventi Notizie ⏱️ Timeout Operazioni 🔄 Aggiornamenti Dinamici ❌ Errori e Blocchi ``` --- ## 🔧 Risoluzione Problemi ### **Problema: Bot non apre posizioni** **Controlli in ordine:** 1. ✅ **Giorno Consentito**: Verifica giorni di trading 2. ✅ **Sessione Attiva**: Verifica orari EU/US 3. ✅ **Spread OK**: Deve essere < Max Spread 4. ✅ **Protezioni**: Nessuna protezione attiva 5. ✅ **Conferme**: Segnali sufficienti 6. ✅ **Volatilità**: Nei limiti configurati 7. ✅ **Max Posizioni**: Limite non raggiunto **Log da cercare:** ``` ❌ Matrix Gold: Trading non consentito il venerdì ❌ Matrix Gold: Trading bloccato da protezione perdite consecutive ❌ Matrix Gold: Trading bloccato da filtro notizie ⚠️ Segnale Matrix Gold troppo debole: 0.008 < 0.012 ``` ### **Problema: Troppe perdite consecutive** **Soluzioni:** 1. **Riduci Perdite Consecutive Max**: Da 3 a 2 2. **Aumenta Cooldown**: Da 60 a 90+ minuti 3. **Abilita Ferma Tutte Posizioni**: true 4. **Cambia Modalità**: Da Aggressiva a Conservativa 5. **Aumenta Conferme Minime**: Da 2 a 3+ ### **Problema: SL troppo piccolo** **Cause e Soluzioni:** ``` Causa: % rischio troppo basso (es. 0.01%) Soluzione: Aumenta a 0.1%+ o disabilita Rischio Dinamico Causa: Volume troppo alto per conto piccolo Soluzione: Riduci Volume Base Causa: Protezione attiva Soluzione: Attendi reset protezione ``` ### **Problema: Bot ignora le notizie** **Verifiche:** ``` ✅ Filtro Notizie abilitato nelle impostazioni ✅ Verifica orari GMT corretti ✅ Controlla impostazioni Pre/Post Notizie ✅ Monitora log per conferma attivazione ``` --- ## ❓ FAQ ### **D: Qual è la configurazione migliore per iniziare?** **R:** ``` Modalità: Bilanciata Perdite Consecutive Max: 3 Cooldown: 60 min Azione Posizioni Notizie: Pausa Durata Massima Trade: 30 min Rischio: max 1% Crescita Composta: OFF inizialmente ``` ### **D: Perché il bot si ferma spesso?** **R:** Il bot ha molte protezioni. Controlla: - Perdite consecutive raggiunte - Eventi notizie attivi - Fuori sessione/giorno consentito - Spread troppo alto - Circuit breaker attivo ### **D: Come ottimizzare le prestazioni?** **R:** 1. **Backtesting**: Prova diverse configurazioni 2. **Demo Prima**: Mai live senza test 3. **Monitora Drawdown**: Mai superare 5-10% 4. **Regola Gradualmente**: Un parametro alla volta 5. **Conserva Log**: Per analisi post sessione ### **D: Quando usare le diverse modalità perdite consecutive?** **R:** - **Cooldown**: Sempre sicuro, prevedibile - **Trend Reverse**: Per trader esperti, meno prevedibile - **Rischio Ridotto**: Mercati stabili, voglia di continuare ### **D: Come gestire la crescita composta?** **R:** ``` Inizio: OFF (testa stabilità prima) Tasso: max 1-2% (crescita graduale) Monitoraggio: Controlla incrementi volume Stop: Se aumenta drawdown ``` ### **D: Posso fare trading su altri simboli oltre XAUUSD?** **R:** Il bot è ottimizzato per l’oro. Altri simboli richiedono modifiche parametri (SL, TP, volatilità, livelli S/R). ### **D: Come interpretare la Forza del Trend?** **R:** ``` 0.0-0.2: Trend debole (pochi segnali) 0.2-0.5: Trend moderato 0.5-0.8: Trend forte (buoni segnali) 0.8-1.0: Trend molto forte (segnali eccellenti) ``` --- ## 🎯 Checklist Avvio Bot ### **Prima di Iniziare:** - [ ] Account demo testato per 1+ settimane - [ ] Parametri ottimizzati per il tuo stile - [ ] Rischio per trade sotto il 2% - [ ] Protezioni perdite consecutive configurate - [ ] Filtro notizie abilitato - [ ] Giorni di trading selezionati correttamente - [ ] Durata massima trade impostata - [ ] Pannelli di visualizzazione abilitati per monitoraggio ### **Monitoraggio Attivo:** - [ ] Controlla log ogni ora nei primi giorni - [ ] Verifica attivazioni protezioni - [ ] Monitora drawdown massimo - [ ] Osserva pattern perdite consecutive - [ ] Testa gestione eventi notizie ### **Ottimizzazione Continua:** - [ ] Analizza performance settimanali - [ ] Regola parametri gradualmente - [ ] Mantieni statistiche dettagliate - [ ] Backup configurazioni funzionanti --- **Matrix Gold Resurrection** - Trading Automatizzato Sicuro e Professionale *Sviluppato per trader che danno priorità alla protezione del capitale*