╔══════════════════════════════════════════════════════════════╗

║ AI US500 PRO ║

║ cBot hybride de tendance / moyenne-réversion ║

║ Multi-IA • Multi-Échelle de temps ║

╚══════════════════════════════════════════════════════════════╝

🧠 **AI US500 PRO** est un cBot professionnel pour cTrader spécialement conçu pour l'indice S&P 500 (US500). Il combine une analyse technique multi-échelle de temps avec l'intelligence artificielle pour filtrer chaque trade avant exécution.

Le bot opère sur **3 échelles de temps simultanées** (H4 → H1 → M15), détecte automatiquement le régime de marché (tendance ou range) et applique la stratégie la plus adaptée : suivi de tendance lorsque le marché est directionnel, moyenne-réversion lorsqu'il évolue latéralement. Chaque signal généré peut être validé en temps réel par un modèle d'IA de votre choix parmi **13 fournisseurs supportés**.

Fonctionne avec `AccessRights.None` — aucune permission spéciale requise, utilise les API HTTP natives de cTrader.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📐 **ARCHITECTURE DE LA STRATÉGIE**

Le bot suit un flux de décision en cascade :

```

H4 (EMA 200) → Détermine la tendance directionnelle à long terme (haussière / baissière / neutre)

↓

H1 (EMA 50 + RSI 14) → Confirme la direction et évalue la sur-extension

↓

M15 (EMA 21/50 + Stoch + BB + ADX + ATR) → Génère le signal d'entrée

↓

IA (Claude / GPT / Gemini / ...) → Filtre le signal avec un score de confiance

↓

Exécution → Calcul du volume, SL/TP dynamique, trailing stop

```

⚡ **Détection du régime (ADX)**

— ADX ≥ seuil → marché en tendance → stratégie de suivi de tendance

— ADX < seuil → marché en range → stratégie de moyenne-réversion

Le changement est entièrement automatique, barre par barre.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 **STRATÉGIE DE SUIVI DE TENDANCE**

Conditions d'entrée LONG :

✅ H4 : prix au-dessus de l'EMA 200 (biais haussier)

✅ H1 : prix au-dessus de l'EMA 50 + RSI > 50

✅ M15 : EMA 21 croise au-dessus de l'EMA 50 (croisement haussier)

✅ M15 : Stochastique K croise au-dessus de D, avec K < 65 (pas en surachat)

Conditions d'entrée SHORT : miroir et inverse.

📊 **STRATÉGIE DE MOYENNE-RÉVERSION**

Conditions d'entrée LONG :

✅ ADX en dessous du seuil (marché en range)

✅ M15 : le prix touche ou casse la bande inférieure de Bollinger

✅ M15 : Stochastique K < 20 (survendu)

✅ H1 : RSI < 35 (sur-extension baissière)

Conditions d'entrée SHORT : miroir et inverse.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🤖 **INTÉGRATION IA — 13 FOURNISSEURS**

Lorsque le bot génère un signal technique valide, avant exécution il envoie à l'IA un paquet de données complet contenant :

— Tous les indicateurs multi-échelle de temps

— Les N dernières chandelles M15 (OHLCV)

— Direction proposée et stratégie active

— Paramètres de risque (SL/TP en pips, ratio R:R)

— Statut du compte et positions ouvertes

L'IA répond avec :

— **Score de confiance** (0-100%)

— **Décision** (GO / NO_GO)

— **Facteurs clés** (2-3 facteurs principaux)

— **Avertissement de risque** (risque principal identifié)

Si la confiance est inférieure au seuil minimum, le trade est **bloqué**.

Après chaque clôture de trade, l'IA fournit également une **analyse post-trade** avec évaluation, notation et leçon apprise.

**Fournisseurs supportés :**

```

1. Anthropic (Claude) — claude-sonnet-4

2. OpenAI (ChatGPT) — gpt-4o

3. Google (Gemini) — gemini-2.0-flash

4. Mistral — mistral-large-latest

5. Groq — llama-3.3-70b-versatile

6. Perplexity — sonar-pro

7. Cohere — command-r-plus

8. xAI (Grok) — grok-2

9. DeepSeek — deepseek-chat

10. Together AI — Llama-3.3-70B-Instruct-Turbo

11. Fireworks AI — llama-v3p3-70b-instruct

12. OpenRouter — anthropic/claude-sonnet-4

13. Ollama (local, gratuit) — llama3.1

```

Chaque fournisseur a une URL et un modèle par défaut préconfigurés. Vous pouvez remplacer à la fois le modèle et l'URL pour une flexibilité maximale.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔧 **PARAMÈTRES — GUIDE COMPLET**

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

💰 **1. GESTION DU RISQUE**

▸ **Mode de risque** — `PercentRisk` / `FixedLot`

Choisissez entre une taille de position basée sur un pourcentage ou un lot fixe. En mode PercentRisk, le bot calcule automatiquement le volume en fonction de la distance du stop loss et du capital disponible. Par défaut : `PercentRisk`

▸ **% de risque par trade** — 0,1 % à 5,0 %

Pourcentage du solde du compte risqué sur chaque trade. Le volume est calculé de sorte que si le SL est atteint, la perte correspond exactement à ce pourcentage. Par défaut : `1,0 %`

▸ **Volume fixe (lots)** — 0.01 et plus

Volume fixe en lots, utilisé uniquement lorsque le mode de risque est réglé sur FixedLot. Par défaut : `0,1`

▸ **Positions ouvertes max** — 1 à 10

Nombre maximum de positions que le bot peut détenir simultanément. Lorsque la limite est atteinte, aucun nouveau trade n'est ouvert. Par défaut : `3`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📈 **2. BIAIS DE TENDANCE H4**

▸ **Période EMA H4** — 50 et plus

Période de l'EMA appliquée à l'échelle de temps H4. Détermine le biais directionnel à long terme. Prix au-dessus de l'EMA = biais haussier, en dessous = baissier. Un tampon basé sur l'ATR évite les faux signaux lorsque le prix est trop proche de la moyenne. Par défaut : `200`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔍 **3. CONFIRMATION H1**

▸ **Période EMA H1** — 10 et plus

Période de l'EMA sur l'échelle de temps H1. Le prix doit être du bon côté de cette EMA pour confirmer l'entrée. Par défaut : `50`

▸ **Période RSI H1** — 5 et plus

Période de l'indice de force relative sur H1. Utilisé à la fois pour la confirmation de tendance (RSI > 50 pour les longs, < 50 pour les shorts) et le filtrage de sur-extension en moyenne-réversion (RSI < 35 ou > 65). Par défaut : `14`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎯 **4. ENTRÉE M15**

▸ **Période EMA rapide** — 5 et plus

EMA rapide sur l'échelle de temps d'entrée (M15). Le croisement avec l'EMA lente génère le signal de suivi de tendance. Par défaut : `21`

▸ **Période EMA lente** — 10 et plus

EMA lente. Le croisement EMA rapide/lente est le déclencheur principal pour la stratégie de tendance. Par défaut : `50`

▸ **Stochastique K / D / Slowing** — périodes de l'oscillateur stochastique

Utilisé comme confirmation de momentum. En stratégie de tendance, il filtre les entrées dans des zones non extrêmes ; en moyenne-réversion, il identifie les zones de surachat/survente. Par défaut : `K=14, D=3, Slowing=3`

▸ **Période Bollinger** — 10 et plus

Période des bandes de Bollinger. En moyenne-réversion, un contact avec la bande supérieure/inférieure déclenche l'entrée. Par défaut : `20`

▸ **Écart-type Bollinger** — 1,0 et plus

Écart-type des bandes. Valeurs plus élevées = bandes plus larges = signaux moins nombreux mais plus fiables. Par défaut : `2,0`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🌡️ **5. DÉTECTION DU RÉGIME (ADX)**

▸ **Période ADX** — 7 et plus

Période du système de mouvement directionnel. Mesure la force de la tendance indépendamment de la direction. Par défaut : `14`

▸ **Seuil de tendance ADX** — 15 à 40

Seuil séparant les marchés en tendance des marchés en range. ADX au-dessus de cette valeur = suivi de tendance actif ; en dessous = moyenne-réversion active. Par défaut : `25`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🛡️ **6. SL / TP (BASÉ SUR ATR)**

Tous les stops loss et take profits sont dynamiques, calculés comme des multiples de l'ATR actuel. Cela signifie qu'ils s'adaptent automatiquement à la volatilité : stops serrés sur marchés calmes, stops plus larges sur marchés volatils.

▸ **Période ATR** — 5 et plus

Période de l'Average True Range. Mesure la volatilité récente et sert de base pour les calculs de SL, TP, breakeven et trailing. Par défaut : `14`

▸ **SL x ATR** — 0,5 et plus

Multiplicateur ATR pour le stop loss. Ex : avec ATR = 20 points et multiplicateur 1,5, le SL sera à 30 points du prix d'entrée. Par défaut : `1,5`

▸ **TP x ATR (Tendance)** — 1,0 et plus

Multiplicateur ATR pour le take profit en suivi de tendance. Typiquement plus élevé que le SL pour un ratio R:R favorable. Par défaut : `2,5`

▸ **TP x ATR (Réversion)** — 0,5 et plus

Multiplicateur ATR pour le take profit en moyenne-réversion. Typiquement plus conservateur car la cible est un retour à la moyenne. Par défaut : `1,5`

▸ **SL min (pips)** — 1 et plus

Stop loss minimum en pips. Si le calcul ATR produit un SL inférieur à cette valeur, le minimum est utilisé à la place. Protège contre des stops trop serrés en conditions de volatilité ultra-faible. Par défaut : `10`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔄 **7. TRAILING STOP**

Système de gestion active des positions ouvertes avec breakeven automatique et trailing stop, tous deux basés sur l'ATR.

▸ **Activer le trailing** — On/Off

Active/désactive l'ensemble du système de trailing. Lorsque désactivé, les positions conservent leur SL/TP fixe jusqu'à la clôture. Par défaut : `On`

▸ **Breakeven après x ATR** — 0,3 et plus

Lorsque le profit non réalisé atteint ce multiple d'ATR, le SL est déplacé au prix d'entrée (+ moitié du spread pour couvrir les coûts). Le trade devient sans risque. Par défaut : `1,0`

▸ **Distance trailing x ATR** — 0,5 et plus

Distance du trailing stop par rapport au prix actuel, exprimée en multiple d'ATR. Le SL suit le prix et ne recule jamais. Par défaut : `1,2`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🕐 **8. FILTRE DE SESSION**

Filtre l'activité de trading selon l'heure. Le US500 se comporte très différemment pendant le pré-marché, la session régulière et l'après-séance.

▸ **Activer le filtre de session** — On/Off

Active/désactive le filtre temporel. Par défaut : `On`

▸ **Début de session (heure CET)** — 0-23

Heure de début de la fenêtre de trading (heure CET). Par défaut : `15` (ouverture de la session US)

▸ **Fin de session (heure CET)** — 0-23

Heure de fin de la fenêtre de trading. Par défaut : `22` (fermeture de la session US)

Le bot supporte également les sessions qui traversent minuit (ex. Début=22, Fin=6).

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙️ **9. DIVERS**

▸ **Cooldown (barres)** — 0 et plus

Nombre minimum de barres M15 devant s'écouler entre un trade et le suivant. Évite le sur-trading dans les situations de signaux rapides. Par défaut : `3` (= 45 minutes)

▸ **Afficher le tableau de bord** — On/Off

Affiche/masque le tableau de bord sur le graphique avec le régime, le biais, les indicateurs, le P&L, le statut IA et les statistiques en direct. Par défaut : `On`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🤖 **10. ANALYSE IA**

▸ **Activer le filtre IA** — On/Off

Active/désactive le filtre IA. Lorsque désactivé, le bot fonctionne uniquement sur l'analyse technique. Par défaut : `Off`

▸ **Fournisseur IA** — sélection parmi 13 fournisseurs

Choisissez le fournisseur IA à utiliser. Chaque fournisseur a une URL et un modèle par défaut préconfigurés. Par défaut : `Anthropic`

▸ **Clé API** — chaîne de caractères

Votre clé API pour le fournisseur sélectionné. Obligatoire pour tous les fournisseurs sauf Ollama (qui fonctionne localement). Laissez vide si vous utilisez Ollama.

▸ **Modèle (vide=par défaut)** — chaîne de caractères

Remplacement du modèle IA. Laissez vide pour utiliser le modèle par défaut du fournisseur sélectionné. Utile pour tester des modèles spécifiques (ex. "gpt-4o-mini", "claude-haiku-4-5-20251001").

▸ **URL API personnalisée (vide=par défaut)** — chaîne de caractères

Remplacement de l'URL API. Utile pour Ollama sur un port personnalisé, proxies d'entreprise ou points de terminaison personnalisés.

▸ **Confiance min. (%)** — 30 à 95

Seuil minimum de confiance IA pour approuver un trade. Si l'IA retourne un score inférieur, le trade est bloqué même si tous les signaux techniques sont valides. Par défaut : `65`

▸ **Fail Open (autoriser en cas d'erreur)** — On/Off

Comportement lorsque l'IA échoue (timeout, API indisponible, réponse mal formée). On = le trade passe quand même (fail-open). Off = le trade est bloqué (fail-closed). Par défaut : `On`

▸ **Revue IA post-trade** — On/Off

Lorsqu'activé, après chaque clôture de trade le bot envoie les détails du résultat à l'IA qui fournit une évaluation, une note (BON/NEUTRE/MAUVAIS) et une leçon apprise. Tout est enregistré dans la console. Par défaut : `On`

▸ **Barres de prix à l'IA** — 5 à 25

Nombre de chandelles M15 récentes envoyées à l'IA dans le contexte d'analyse. Plus de barres = plus de contexte mais plus de tokens consommés. Par défaut : `12`

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 **TABLEAU DE BORD SUR LE GRAPHIQUE**

Le tableau de bord affiche en temps réel :

— Régime actuel (TENDANCE / RANGE)

— Biais H4 (HAUSSIER / BAISSIER / NEUTRE)

— Valeurs ADX, ATR, RSI H1

— Positions ouvertes / maximum

— P&L ouvert, solde, equity

— Statut de la session (ACTIVE / FERMÉE)

— Nombre total de trades et taux de réussite %

— Statut IA : fournisseur, dernière décision, confiance

— Nombre d'appels IA et trades bloqués

La couleur change automatiquement : 🟢 vert lorsque le P&L est positif, 🔴 rouge lorsqu'il est négatif.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📌 **NOTES TECHNIQUES**

— Échelle de temps recommandée : **M15** (le bot avertit s'il est utilisé sur d'autres TF)

— `AccessRights.None` — aucune permission spéciale requise

— Utilise la fonction native `Http.Send()` de cTrader pour les appels IA

— Compatible avec cTrader 4.2+ (.NET 6)

— Supporte le backtesting (sans IA) et le trading en direct (avec ou sans IA)

— Les positions du bot sont identifiées par le label `AiUS500Pro`

— N'interfère pas avec les positions manuelles ou d'autres bots

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚠️ **AVERTISSEMENT**

Ce cBot est fourni à des fins éducatives et informatives uniquement. Le trading d'indices comporte un risque important de perte de capital. Les résultats passés ne garantissent pas les performances futures. L'intégration de l'IA améliore le filtrage mais n'élimine pas le risque. Testez toujours sur un compte démo avant d'utiliser sur un compte réel. Vous êtes seul responsable de vos décisions de trading.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━