Alligator Learn — outil pédagogique M15

Outil de génération de signaux sur EUR/USD M15 basé sur l'Alligator de Bill Williams (3 SMMA décalées). Détection d'un Lips cross dans le sens où les mâchoires sont fanned et la "bouche ouverte" — entrée sur micro-pullback en trend. Objectif : entraîner ton œil à lire la structure d'un trend via 8-15 signaux par jour.

🛑🛑 STATUT au 2026-05-12 : EDGE OOS NÉGATIF — STRATÉGIE FIGÉE. Backtest 6 ans 4 mois Dukascopy : 2 053 trades, expectancy IS +0.060 R mais OOS −0.101 R (dégradation marquée), hit rate OOS 27.9% (sous le break-even RR=2.0 = 33.3%), max DD OOS −114.6 R. 3/4 gates échouent. Décomposition annuelle : 3/7 ans positifs (dont 2023 marginal +0.022), 4/7 ans nettement négatifs.

Verdict détaillé : mt5/AUDIT_2026-05-12_learn_backtest.md.

Conséquence opérationnelle : l'EA Alligator_Learn_v1.mq5 produit des signaux à fréquence raisonnable (~1-3/jour selon contexte) mais les suivre systématiquement ferait perdre. Si l'EA est attaché, l'usage pédagogique réel devient :

• 🎓 utiliser les signaux comme contre-exemples (apprendre à reconnaître quand SKIP, journaliser les "✗" majoritaires)
• 🎓 observer la dégradation IS → OOS (régime change, overfit)
• 🚫 ne PAS les suivre comme stratégie, même en démo

La fréquence promise dans cette fiche (5-15/jour) est exacte. Le hit rate OOS 28% est très en dessous du break-even RR=2.0 (33.3%), confirmant qu'il n'y a pas d'edge à RR=2.0 fixe sur cette TF. Variantes possibles (MinFanPips=3-5, SL/TP ATR-based, trailing stop, filtre session, fractal Williams) non testées — toute reprise sous nouveau nom (Alligator_Learn_v2).

🛑 STATUT ORIGINEL : OUTIL PÉDAGOGIQUE — PAS D'EDGE VALIDÉ. Cette mécanique n'a fait l'objet d'aucun backtest OOS, d'aucune validation walk-forward, d'aucun gate. Les seuils (5/8/13 SMMA, MinFan=1 pip, RR=2.0) sont des choix classiques Bill Williams pour la lisibilité visuelle, pas pour maximiser l'expectancy.

L'EA mt5/Alligator_Learn_v1.mq5 est SIGNAL_ONLY à perpétuité par construction : il n'inclut PAS le module LonBO_Order.mqh, aucune fonction OrderSend n'est appelable depuis ce code. La seule façon d'exécuter ces signaux serait de réécrire l'EA — ce qui ne doit JAMAIS arriver sans passer le même gate backtest que LonBO (fiche → spec → backtest Dukascopy M15 5+ ans → 4 gates OOS verts).

La valeur d'apprentissage est dans le journal manuel des décisions "prendre/skip" associées à chaque signal reçu, pas dans la stratégie elle-même.

À quoi ça sert (vraiment)

Tu reçois des signaux Telegram quand le prix M15 traverse la Lips line (la plus rapide des 3 SMMA) dans le sens où l'Alligator est "réveillé" (lignes fanned, mâchoire ouverte). C'est le setup canonique Bill Williams pour entrer sur un retracement dans un trend établi.

L'apprentissage clé : développer l'œil pour distinguer un Alligator awake (trend) d'un Alligator sleeping (range). Cette compétence transfère à n'importe quelle stratégie trend-following manuelle que tu utiliseras plus tard.

Méthode :

1. Tu reçois le signal Telegram
2. Tu ouvres le chart M15 dans MT5 (l'Alligator est dessiné par défaut si tu l'ajoutes au template)
3. Tu décides en 10 secondes : "✓ je prendrais" / "✗ skip" + raison en 1 mot
4. Tu notes dans ton journal

Au bout de 2 semaines, tu sauras lire visuellement un Alligator sans réfléchir, ce qui vaut largement le bot.

Pourquoi Alligator

Bill Williams a designé cet indicateur pour le forex spécifiquement (et le futures, mais il insistait sur le FX comme terrain pédagogique). L'analogie :

• L'alligator dort quand les 3 lignes sont entrelacées → le marché ne va nulle part → ne pas trader
• L'alligator se réveille quand les lignes commencent à diverger → un trend se forme → préparer une entrée
• L'alligator mange quand les lignes sont clairement fanned (Lips au-dessus de Teeth au-dessus de Jaw pour up-trend, inverse pour down) → trend en cours → entrer sur pullback vers Lips
• L'alligator est rassasié quand les lignes commencent à se rapprocher → trend s'essouffle → fermer

Cette progression visuelle est très lisible et c'est ce qu'on cherche pour l'apprentissage.

Mécanique

Indicateurs (Alligator Bill Williams classique) :
  Jaw   = SMMA(13, shift=8)  sur prix médian (H+L)/2  — la plus lente, "mâchoire"
  Teeth = SMMA(8,  shift=5)  sur prix médian (H+L)/2  — moyenne, "dents"
  Lips  = SMMA(5,  shift=3)  sur prix médian (H+L)/2  — la plus rapide, "lèvres"

Notation : on évalue tout au close du bar M15 i=1 (dernier bar fermé).

1. Filtre awake bullish (LONG candidate) :
   - Lips(i=1) > Teeth(i=1) > Jaw(i=1)
   - Mouth opened : (Lips - Jaw)(i=1) >= MinFanPips × pip

2. Filtre awake bearish (SHORT candidate) :
   - Lips(i=1) < Teeth(i=1) < Jaw(i=1)
   - Mouth opened : (Jaw - Lips)(i=1) >= MinFanPips × pip

3. Déclencheur Lips cross :
   - LONG  : close(i=2) <= Lips(i=2) ET close(i=1) > Lips(i=1)
             → le prix a traversé la Lips de bas en haut au close du bar i=1
   - SHORT : close(i=2) >= Lips(i=2) ET close(i=1) < Lips(i=1)
             → symétrique

4. Cooldown global : 15 min minimum entre 2 signaux (toutes directions
   confondues). Une consolidation peut générer plusieurs micro-crossings ;
   le cooldown coupe le bruit.

5. Filtre coût : skip si spread courant > MaxSpreadPoints (10 = 1 pip
   sur 5-digit). Loggé "skip_spread".

6. Pas de filtre session : actif 24/5. L'apprentissage inclut "comment
   l'Alligator se comporte selon les sessions" (Asia souvent en sleeping,
   London awake, NY awake bruyant).

7. Stop / Take Profit : fixes en pips.
   - SL = entry − 15 pips (LONG) / entry + 15 pips (SHORT)
   - TP = entry + 30 pips (LONG) / entry − 30 pips (SHORT)
   - RR théorique = 2.0 (informatif, non exécuté).

   Justification SL=15 : ~1× ATR(14) M15 typique sur EUR/USD. C'est
   approximativement la distance Lips-Teeth ou Teeth-Jaw lors d'un trend
   moyen. Pas optimisé.

Paramètres par défaut

Sur les shifts : les valeurs 8/5/3 sont la signature Bill Williams classique. L'effet : la ligne Jaw "visible" au bar i=1 est calculée à partir des bars autour de i=1+8 (donc 9 bars dans le passé), ce qui rend l'Alligator volontairement lent à réagir. C'est intentionnel — c'est cette inertie qui fait que les lignes restent fanned pendant un trend complet, pas juste 2 bars. Si tu veux une version réactive, mets les 3 shifts à 0 (déformation de la spec, à documenter dans ton journal si tu testes).

Fréquence attendue

Estimation rough sur EUR/USD M15 :

• 96 bars M15 par jour ouvré
• L'Alligator est awake (Lips fan width ≥ 1 pip ET Lips/Teeth/Jaw alignés) ~40-60% du temps sur EUR/USD (plus en London/NY, moins en Asia)
• Un Lips cross dans le bon sens se produit ~5-10% des bars où l'awake filter passe
• Donc 5-10 signaux/jour typique, avec pics à 15/jour les jours de forte volatilité

Plage attendue : 5-15 signaux/jour, médiane 7-8. Sur 2 semaines ouvrées : 50-150 signaux. C'est moins que RSI Pullback (qui vise 10-20/jour) — c'est volontaire, Alligator privilégie la qualité visuelle sur la quantité.

Pièges connus

1. Alligator vient juste de se réveiller (premier cross fragile)

Quand les lignes passent de sleeping (entrelacées) à awake (fanned), le premier Lips cross dans le nouveau sens est souvent un piège : volatilité naissante peu directionnelle. Visuellement, tu verras "lignes très proches qui commencent à se séparer + close au-dessus de Lips". L'expérience pédagogique : note ces cas comme "✗ Alligator fresh wake" dans ton journal — si tu le repères 5 fois et que c'est 5 fois perdant, tu as une heuristique de skip robuste.

2. Pullback profond contre la mâchoire

Parfois le prix retrace jusqu'à Jaw (la plus lente) avant de continuer. Le Lips cross se produit alors AU REBOND, ce qui est techniquement OK mais le SL fixe à 15 pips peut sauter si le pullback dépasse. Visuellement : prix qui descend jusqu'à toucher Jaw, puis remonte par Lips. Heuristique de skip possible : "skip si close(i=1) - Lips(i=1) > 5 pips" (le cross est tardif).

3. Alligator awake mais flat

Les 3 lignes peuvent être empilées dans l'ordre Lips > Teeth > Jaw avec une fan width de 1.5 pip mais quasi horizontales (consolidation latérale après un trend). Le filtre MinFanPips passe mais le marché n'est pas en trend actif. Heuristique : à l'œil, regarde si Jaw monte (pente positive) ou est plate. Le bot ne le détecte pas — tu le détectes.

4. News imminente

Aucun filtre news intégré (idem RSI Learn). À toi de consulter Forex Factory avant chaque signal.

5. Lips cross au close d'une bougie qui sort de range étroit

Si l'EUR/USD vient de passer 6 bars dans 10 pips, l'Alligator est probablement endormi (lignes croisées). Une bougie soudaine qui sort du range va déclencher un Lips cross — mais l'Alligator était sleeping, donc l'awake filter peut juste basculer "true" sur ce même bar. Cas frontière, à observer en pratique.

6. Différence entre Alligator MT5 et Alligator displayé

Le terminal MT5 dessine l'Alligator au-dessus du chart. Quand tu reçois un signal Telegram, vérifie sur le chart MT5 que les 3 lignes ressemblent à ce que le bot a évalué. Si tu vois un Alligator clairement sleeping mais que le bot a déclenché un signal, il y a un bug — log-le et préviens.

Variantes envisagées (non testées, ne pas implémenter sans gate)

Toutes ces variantes sont hors scope de cet outil pédagogique. Si une te semble prometteuse après l'observation, le bon chemin reste : nouvelle fiche → nouvelle spec → backtest Dukascopy → 4 gates OOS.

Format des messages Telegram

🟢 Alligator Learn LONG EURUSD [SIGNAL ONLY]
Entry: 1.08750
SL:    1.08600 (-15 pips)
TP:    1.09050 (+30 pips, RR=2.0)
Jaw:   1.08580 | Teeth: 1.08650 | Lips: 1.08720
Fan width: 14 pips (Lips - Jaw)
Cross: close i=2=1.08710 → i=1=1.08750
Cooldown next: 15 min

Le bandeau [SIGNAL ONLY] est en dur dans le code.

Pour distinguer ce flux de celui de RSI Learn dans le même bot Telegram : le préfixe Alligator Learn (vs RSI Learn) suffit visuellement. Si tu trouves ça encombrant, tu peux créer un 2e bot Telegram dédié — mais à ce stade ça surcharge inutilement.

Comparaison avec les autres EAs

Le bot Telegram LonBO est réutilisé pour les 2 outils Learn. Les préfixes dans les messages (RSI Learn / Alligator Learn) suffisent pour distinguer les flux.

Couplage avec piliers A et B

• Pilier A (cette fiche) : la spec descriptive vit ici
• Pilier B (Hermes) : PAS d'entrée dans hermes/src/strategies/. Outil pédagogique côté C uniquement.
• Pilier C : code MQL5 minimal, spec exécutable Python, audit statique

Méthode de journal pédagogique recommandée

Identique à RSI Learn (cf. docs/strategies/scalping/rsi-pullback-learn.md), avec une colonne supplémentaire :

L'analyse de fin de période doit révéler : est-ce que mon œil distingue déjà un trend "vrai" d'un trend "frêle" ? Si oui, l'Alligator t'a appris à lire.

Référence croisée

• Spec exécutable : mt5/tests/test_alligator_learn_spec.py
• Code EA : mt5/Alligator_Learn_v1.mq5 + mt5/include/Alligator_*.mqh
• Audit statique : mt5/AUDIT_2026-05-11_learn_tools.md (audit unifié RSI + Alligator)
• KANBAN : section "Pilier C quater — Alligator Learn"
• Fiche jumelle : docs/strategies/scalping/rsi-pullback-learn.md