# Robot di Trading Oro (Premium) - Descrizione del Marketplace

## Panoramica del Prodotto

Gold Trading Robot (Premium) è un cBot a motore singolo che segue la tendenza per **XAUUSD** su **M15**.

È progettato per mantenere la logica di esecuzione robusta e comprensibile pur consentendo una profonda ottimizzazione tramite parametri raggruppati.

Obiettivi di progettazione principali:

- Operare solo su configurazioni confermate da barre chiuse (nessuna decisione di ingresso in stile repaint).

- Utilizzare un modello di segnale chiaro (incrocio EMA + contesto ATR) invece di accumulare molti filtri rigidi.

- Mantenere una gestione del rischio e della posizione rigorosa e sistematica (dimensionamento del rischio sull'equity, logica di stop basata su ATR, protezioni contro il drawdown).

- Mantenere un comportamento protettivo di livello produttivo per spread, drawdown giornaliero/totale, perdite consecutive, cooldown ed esposizione al gap del weekend.

## Come Funziona il Robot

### 1) Mercato e Intervallo Temporale

- La strategia è destinata all'operatività su **XAUUSD, M15**.

- Il calcolo del segnale si basa su barre M15 chiuse, evitando decisioni su candele incomplete.

### 2) Motore del Segnale

- Trigger di direzione: **incrocio EMA veloce / EMA lento**.

- Contesto di volatilità: **Wilder ATR**.

- Modello di qualità: un sistema a **punteggio 0-4** (invece di molti filtri obbligatori).

- Contesto opzionale a timeframe superiore: **filtro di tendenza H1**.

Un segnale è considerato solo se esiste l'incrocio e viene raggiunto il punteggio minimo di qualità.

### 3) Rischio ed Esecuzione Ordini

- Il dimensionamento della posizione si basa su **% di rischio sull'equity per trade**.

- Lo stop iniziale è calcolato come un **multiplo ATR**.

- L'ingresso è bloccato se lo spread corrente è superiore allo spread massimo configurato.

- Il volume è normalizzato in modo conservativo (al ribasso) per evitare di rischiare oltre l'obiettivo.

### 4) Gestione della Posizione

- Non è richiesto un TP fisso dalla logica del motore; le uscite sono gestite da:

- **trigger break-even** (in termini di multiplo R).

- **stop trailing ATR**.

- Gli aggiornamenti dello stop si muovono solo in direzione favorevole e includono un controllo anti-rumore.

### 5) Livello di Protezione

- Le perdite consecutive massime possono attivare un periodo di cooldown.

- Il blocco per drawdown giornaliero impedisce ulteriori ingressi nella giornata.

- Il blocco per drawdown totale impedisce ingressi fino al riavvio (comportamento di blocco di sicurezza).

- La protezione venerdì/weekend può bloccare gli ingressi o chiudere le posizioni prima del gap del weekend.

## Parametri per Gruppo

### Motore del Segnale

- **Periodo EMA Veloce**: Periodo per l'EMA veloce usata nel rilevamento della direzione dell'incrocio.

- **Periodo EMA Lenta**: Periodo per l'EMA lenta usata come riferimento di tendenza di base.

- **Periodo ATR**: Wilder ATR lookback usato per il contesto di volatilità e il calcolo della distanza dello stop.

- **Punteggio Minimo del Segnale (1-4)**: Punteggio minimo di qualità richiesto prima che un incrocio possa essere tradato.

- **Usa Filtro di Tendenza H1**: Abilita/disabilita la conferma della tendenza a timeframe superiore.

- **Corpo Minimo della Candela (x ATR)**: Dimensione minima del corpo della candela come frazione di ATR per la valutazione della qualità.

- **Separazione Minima MA (x ATR)**: Separazione minima tra EMA veloce e lenta come frazione di ATR per la valutazione della qualità.

### Gestione del Rischio

- **Percentuale di Rischio per Trade (% Equity)**: Percentuale target di equity rischiata su ogni nuovo trade.

- **Stop Loss Iniziale (x ATR)**: Distanza iniziale dello stop dall'ingresso come multiplo ATR.

- **Buffer Costo di Esecuzione (pips)**: Buffer di sicurezza aggiuntivo per incertezza su spread/transazione nel dimensionamento del rischio.

- **Spread Massimo (pips)**: Soglia rigida di spread oltre la quale non viene aperto un nuovo ordine.

### Trailing / Break-Even

- **Trailing Stop (x ATR)**: Multiplo ATR usato per seguire lo stop mentre il trade è in profitto.

- **Trigger Break-Even (x R)**: Soglia di profitto (in R) dove lo stop si sposta nella zona di logica break-even.

- **Offset Break-Even (pips)**: Offset extra in pips quando si applica il break-even per evitare uno stop troppo stretto esattamente all'ingresso.

### Protezione

- **Filtro ATR Massimo (pips, 0 = disabilitato)**: Tetto opzionale di volatilità; se l'ATR è superiore a questo, gli ingressi sono saltati.

- **Perdite Consecutive Massime**: Numero di trade in perdita consentiti prima che si attivi la protezione cooldown.

- **Cooldown (barre M15)**: Numero di barre M15 da attendere dopo l'attivazione del cooldown per la serie di perdite.

- **Limite di Drawdown Giornaliero (%)**: Soglia di drawdown sull'equity giornaliero per bloccare ulteriori ingressi.

- **Limite di Drawdown Totale (%)**: Soglia di drawdown di sessione/globale per attivare un blocco di sicurezza a lunga durata.

- **Modalità Protezione Venerdì**: Modalità comportamento gap weekend (off / blocca ingressi / chiudi posizioni).

## Note Operative per gli Utenti del Marketplace

- I migliori risultati dovrebbero essere convalidati con **out-of-sample** e **forward testing**.

- Per XAUUSD, verificare sempre la scala del simbolo e le condizioni del broker (spread, comportamento della sessione, qualità di esecuzione).

- Si raccomanda un'ottimizzazione conservativa rispetto a un adattamento estremo dei parametri.

## A Chi È Destinato Questo Robot

- Trader che desiderano un motore di tendenza trasparente con forti controlli sul rischio.

- Utenti che preferiscono un controllo parametrizzato sia sulla rigidità del segnale che sul comportamento di sicurezza.

- Utenti sistematici che possono eseguire una convalida robusta (in-sample, OOS, forward) prima del deployment live.