# Robot de Trading Or (Premium) - Description du Marché

## Aperçu du Produit

Le Robot de Trading Or (Premium) est un cBot à moteur unique suivant la tendance pour **XAUUSD** sur **M15**.

Il est conçu pour garder une logique d'exécution robuste et compréhensible tout en permettant une optimisation approfondie via des paramètres groupés.

Objectifs principaux de conception :

- Trader uniquement des configurations confirmées à partir de barres fermées (pas de décisions d'entrée de type repaint).

- Utiliser un modèle de signal clair (croisement EMA + contexte ATR) au lieu d'empiler de nombreux filtres stricts.

- Maintenir une gestion du risque et des positions stricte et systématique (dimensionnement du risque en capital, logique de stop basée sur l'ATR, protections contre les drawdowns).

- Maintenir un comportement protecteur de qualité production pour le spread, le drawdown quotidien/total, les pertes consécutives, le refroidissement et l'exposition aux gaps du weekend.

## Comment Fonctionne le Robot

### 1) Portée du Marché et de l'Échelle Temporelle

- La stratégie est destinée à l'opération sur **XAUUSD, M15**.

- Le calcul du signal est basé sur des barres M15 fermées, évitant les décisions sur des chandeliers incomplets.

### 2) Moteur de Signal

- Déclencheur de direction : **croisement EMA rapide / EMA lente**.

- Contexte de volatilité : **ATR de Wilder**.

- Modèle de qualité : un système de **score 0-4** (au lieu de nombreux filtres obligatoires).

- Contexte optionnel sur une échelle temporelle supérieure : **filtre de tendance H1**.

Un signal est considéré uniquement si un croisement existe et que le score de qualité minimum est atteint.

### 3) Gestion du Risque et Exécution des Ordres

- Le dimensionnement de la position est basé sur **% du risque en capital par trade**.

- Le stop initial est calculé comme un **multiple de l'ATR**.

- L'entrée est bloquée si le spread actuel est supérieur au spread max configuré.

- Le volume est normalisé de manière conservatrice (à la baisse) pour éviter de risquer au-delà de la cible.

### 4) Gestion des Positions

- Aucun TP fixe n'est requis par la logique du moteur ; les sorties sont gérées par :

- **Déclencheur de break-even** (dans l'espace des multiples R).

- **Stop suiveur ATR**.

- Les mises à jour du stop ne se déplacent que dans la direction favorable et incluent un contrôle anti-bruit.

### 5) Couche de Protection

- Les pertes consécutives maximales peuvent déclencher un refroidissement.

- Le verrouillage du drawdown quotidien bloque les entrées supplémentaires pour la journée.

- Le verrouillage du drawdown total bloque les entrées jusqu'au redémarrage (comportement de verrouillage de sécurité).

- La protection vendredi/weekend peut bloquer les entrées ou fermer les positions avant le gap du weekend.

## Paramètres Par Groupe

### Moteur de Signal

- **Période EMA Rapide** : Période pour l'EMA rapide utilisée dans la détection de la direction du croisement.

- **Période EMA Lente** : Période pour l'EMA lente utilisée comme référence de tendance de base.

- **Période ATR** : Lookback ATR de Wilder utilisé pour le contexte de volatilité et les calculs de distance de stop.

- **Score Minimum du Signal (1-4)** : Score de qualité minimum requis avant qu'un croisement puisse être tradé.

- **Utiliser le Filtre de Tendance H1** : Active/désactive la confirmation de tendance sur une échelle temporelle supérieure.

- **Taille Minimum du Corps de la Bougie (x ATR)** : Taille minimum du corps de la bougie en fraction d'ATR pour le scoring de qualité.

- **Séparation Minimum des MA (x ATR)** : Séparation minimum entre EMA rapide et lente en fraction d'ATR pour le scoring de qualité.

### Gestion du Risque

- **Pourcentage de Risque par Trade (% Capital)** : Pourcentage cible du capital risqué sur chaque nouveau trade.

- **Stop Loss Initial (x ATR)** : Distance initiale du stop par rapport à l'entrée en multiple d'ATR.

- **Marge de Coût d'Exécution (pips)** : Marge de sécurité supplémentaire pour l'incertitude du spread/transaction dans le dimensionnement du risque.

- **Spread Max (pips)** : Seuil dur de spread au-dessus duquel aucun nouvel ordre n'est ouvert.

### Stop Suiveur / Break-Even

- **Stop suiveur (x ATR)** : Multiple d'ATR utilisé pour suivre le stop pendant que le trade est en profit.

- **Déclencheur Break-Even (x R)** : Seuil de profit (en R) où le stop se déplace vers la zone de logique break-even.

- **Décalage Break-Even (pips)** : Décalage supplémentaire en pips lors de l'application du break-even pour éviter un stop trop serré à l'entrée exacte.

### Protection

- **Filtre ATR Max (pips, 0 = désactivé)** : Plafond de volatilité optionnel ; si l'ATR est au-dessus, les entrées sont ignorées.

- **Pertes Consécutives Max** : Nombre de trades perdants autorisés avant que la protection de refroidissement ne se déclenche.

- **Refroidissement (barres M15)** : Nombre de barres M15 à attendre après l'activation du refroidissement suite à une série de pertes.

- **Limite de Drawdown Quotidien (%)** : Seuil de drawdown quotidien du capital pour bloquer les entrées supplémentaires.

- **Limite de Drawdown Totale (%)** : Seuil de drawdown de session/global pour activer un verrouillage de sécurité de longue durée.

- **Mode de Protection Vendredi** : Mode de comportement pour le gap du weekend (désactivé / blocage des entrées / fermeture des positions).

## Notes Opérationnelles Pour les Utilisateurs du Marché

- Les meilleurs résultats doivent être validés avec **hors échantillon** et **tests en avant**.

- Pour XAUUSD, vérifiez toujours l'échelle du symbole et les conditions du courtier (spread, comportement de session, qualité d'exécution).

- Une optimisation conservatrice est recommandée plutôt qu'un ajustement extrême des paramètres.

## Pour Qui Est Ce Robot

- Les traders qui souhaitent un moteur de tendance transparent avec des contrôles de risque solides.

- Les utilisateurs qui préfèrent un contrôle paramétré à la fois sur la rigueur du signal et le comportement de sécurité.

- Les utilisateurs systématiques capables d'effectuer une validation robuste (in-sample, hors échantillon, en avant) avant le déploiement en direct.