Nouveau : la formation trading algorithmique MQL5, MQL4 et ProRealTimeDécouvrir →

MQL5 · Indicateurs

iAlligator en MQL5 : lignes décalées et mesure de l’éveil du marché

Lire les trois lignes de l’Alligator de Bill Williams avec iAlligator, comprendre leurs décalages et mesurer en ATR l’ouverture de la gueule pour filtrer les tendances.

Mis à jour le 23 octobre 2026Lecture : 6 minPar Alix, OptiBot Trading

iAlligator() crée un handle vers l’Alligator de Bill Williams : trois moyennes mobiles lissées du prix médian, chacune décalée vers le futur d’un nombre de bougies différent. L’indicateur expose trois buffers : 0 pour la mâchoire (GATORJAW_LINE), 1 pour les dents (GATORTEETH_LINE) et 2 pour les lèvres (GATORLIPS_LINE). Williams le décrivait avec une métaphore : quand les trois lignes sont emmêlées, l’Alligator dort et le marché n’a pas de tendance ; quand elles s’écartent et s’ordonnent, il se réveille et chasse. Cette page transforme cette image en mesure chiffrée de l’état du marché, utilisable comme filtre dans un robot.

Le calcul de l’Alligator

L’aide de MetaTrader 5 définit les trois lignes à partir du prix médian (HIGH + LOW) / 2 :

LigneCouleurCalculDécalage
Mâchoire (jaw)bleueSMMA(prix médian, 13)8 bougies vers le futur
Dents (teeth)rougeSMMA(prix médian, 8)5 bougies vers le futur
Lèvres (lips)verteSMMA(prix médian, 5)3 bougies vers le futur

Les trois lignes sont des moyennes lissées (SMMA), donc lentes, et le décalage vers la droite accentue encore leur retard apparent par rapport au prix. Quand le marché monte franchement, les lèvres (rapides) passent au-dessus des dents, elles-mêmes au-dessus de la mâchoire ; l’ordre s’inverse en tendance baissière. En range, les lignes se croisent sans cesse. L’aide de MT5 rappelle l’observation de Williams selon laquelle les marchés ne sont en tendance claire que 15 à 30 % du temps, et recommande d’éviter les marchés qui oscillent dans un range étroit.

La fonction iAlligator

int iAlligator(
   string             symbol,          // symbole, NULL = courant
   ENUM_TIMEFRAMES    period,          // unité de temps, 0 = courante
   int                jaw_period,      // période de la mâchoire
   int                jaw_shift,       // décalage de la mâchoire
   int                teeth_period,    // période des dents
   int                teeth_shift,     // décalage des dents
   int                lips_period,     // période des lèvres
   int                lips_shift,      // décalage des lèvres
   ENUM_MA_METHOD     ma_method,       // méthode de lissage
   ENUM_APPLIED_PRICE applied_price    // prix appliqué ou handle d'indicateur
);
BufferConstanteLigne
0GATORJAW_LINEmâchoire
1GATORTEETH_LINEdents
2GATORLIPS_LINElèvres

Pour obtenir l’Alligator standard, utilisez les périodes et décalages 13/8, 8/5, 5/3, la méthode MODE_SMMA et le prix PRICE_MEDIAN : ce sont les valeurs par défaut de l’exemple de la documentation. La fonction renvoie INVALID_HANDLE en cas d’échec.

Lire des lignes décalées

Le décalage pose la même question que pour l’Ichimoku. L’exemple officiel d’iAlligator copie chaque buffer avec une position de départ négative égale à moins son décalage (-jaw_shift, etc.), afin d’inclure la partie des lignes tracée à droite de la dernière bougie. Pour un robot, retenez ceci :

  • à la position 1, vous lisez la valeur affichée sous la dernière bougie clôturée, c’est-à-dire une moyenne calculée 8 (mâchoire), 5 (dents) ou 3 (lèvres) bougies plus tôt. C’est la lecture qui correspond à ce que vous voyez sur le graphique ;
  • si vous voulez au contraire les moyennes les plus récentes, créez le handle avec des décalages à 0 : les trois buffers contiennent alors les SMMA calculées sur la bougie lue, sans aucun retard d’affichage.

Les deux choix sont légitimes, mais ils ne donnent pas les mêmes signaux. Décidez lequel correspond à votre intention et gardez-le. L’exemple ci-dessous utilise les réglages standard et lit la position 1, pour rester fidèle à l’indicateur affiché.

Mesurer l’éveil de l’Alligator

Deux critères suffisent à décrire l’état :

  1. L’ordre des lignes : lèvres > dents > mâchoire en hausse, l’inverse en baisse. Tout autre ordre signifie que les lignes sont emmêlées.
  2. L’ouverture de la gueule : l’écart entre les lèvres et la mâchoire, rapporté à l’ATR pour être comparable d’un marché à l’autre. Une gueule ouverte de plus d’un certain multiple d’ATR, et en train de s’élargir, marque une tendance active.

Exemple : un EA qui classe l’état de l’Alligator

input double InpMinOpen = 0.5;   // ouverture minimale (écart lèvres-mâchoire en ATR)

enum GatorState { GATOR_SLEEP, GATOR_UP, GATOR_DOWN, GATOR_UNCLEAR };

int hGator = INVALID_HANDLE;
int hAtr   = INVALID_HANDLE;

int OnInit()
  {
   hGator = iAlligator(_Symbol, _Period, 13, 8, 8, 5, 5, 3, MODE_SMMA, PRICE_MEDIAN);
   hAtr   = iATR(_Symbol, _Period, 14);
   if(hGator == INVALID_HANDLE || hAtr == INVALID_HANDLE) return(INIT_FAILED);
   return(INIT_SUCCEEDED);
  }

void OnDeinit(const int reason)
  {
   IndicatorRelease(hGator);
   IndicatorRelease(hAtr);
  }

bool ReadState(GatorState &state, double &openAtr)
  {
   double jaw[], teeth[], lips[], atr[];
   ArraySetAsSeries(jaw, true);
   ArraySetAsSeries(teeth, true);
   ArraySetAsSeries(lips, true);
   ArraySetAsSeries(atr, true);
   // Position 0 et 1 : valeurs affichées sous la bougie courante et la dernière clôturée
   if(CopyBuffer(hGator, GATORJAW_LINE,   0, 3, jaw)   < 3) return(false);
   if(CopyBuffer(hGator, GATORTEETH_LINE, 0, 3, teeth) < 3) return(false);
   if(CopyBuffer(hGator, GATORLIPS_LINE,  0, 3, lips)  < 3) return(false);
   if(CopyBuffer(hAtr, 0, 0, 2, atr) < 2 || atr[1] <= 0.0) return(false);

   openAtr = MathAbs(lips[1] - jaw[1]) / atr[1];          // ouverture actuelle en ATR
   double openPrev = MathAbs(lips[2] - jaw[2]) / atr[1];  // ouverture précédente
   bool widening = openAtr > openPrev;

   bool orderUp   = lips[1] > teeth[1] && teeth[1] > jaw[1];
   bool orderDown = lips[1] < teeth[1] && teeth[1] < jaw[1];

   if(!orderUp && !orderDown)                    state = GATOR_SLEEP;
   else if(openAtr >= InpMinOpen && widening)    state = orderUp ? GATOR_UP : GATOR_DOWN;
   else                                          state = GATOR_UNCLEAR;
   return(true);
  }

void OnTick()
  {
   static datetime lastBar = 0;
   static GatorState last = GATOR_UNCLEAR;
   datetime t = iTime(_Symbol, _Period, 0);
   if(t == lastBar) return;

   GatorState s;
   double openAtr;
   if(!ReadState(s, openAtr)) return;
   lastBar = t;

   if(s != last)
     {
      PrintFormat("Alligator : %s (ouverture %.2f ATR)", EnumToString(s), openAtr);
      last = s;
     }
  }

L’ATR et l’Alligator sont lus pour la même bougie (indice 1) afin que le rapport ait un sens. Le principe de lecture de plusieurs handles est détaillé dans Handles d’indicateurs et CopyBuffer. Le seuil InpMinOpen se calibre en observant la distribution de l’ouverture sur votre marché : affichez-la à chaque bougie dans le testeur et repérez les valeurs atteintes pendant les tendances que vous voudriez capter.

Décalé ou non : l’effet sur les signaux

Lire les lignes décalées revient à comparer des moyennes calculées à des instants différents : sous la dernière bougie, la mâchoire affichée date de huit bougies, les lèvres de trois seulement. Cette asymétrie fait partie de l’indicateur tel que Williams l’a conçu ; elle retarde la mâchoire davantage que les lèvres et accentue l’écartement des lignes en début de tendance. Avec des décalages nuls, les trois moyennes sont contemporaines : l’ordre des lignes réagit plus tôt, mais l’ouverture mesurée est plus faible et votre seuil en ATR doit être recalibré. Si vous passez d’une version à l’autre, refaites toute la validation : ce n’est plus le même filtre.

Pour fixer le seuil d’ouverture, une démarche simple consiste à journaliser la valeur openAtr à chaque bougie sur plusieurs années, puis à en examiner la répartition. Un seuil situé autour du tiers supérieur des valeurs observées limite l’état actif à une fraction du temps compatible avec l’observation de Williams sur la rareté des tendances.

Usages en trading algorithmique

  • Filtre de tendance. N’autoriser les entrées d’une stratégie de suivi de tendance que dans les états GATOR_UP ou GATOR_DOWN, et les interdire pendant le sommeil.
  • Sortie. L’aide de MT5 indique que lorsque les lignes se rejoignent à nouveau, il est temps de prendre ses bénéfices. Le passage de l’état actif à l’état de sommeil peut fermer la position ou resserrer le stop.
  • Stop suiveur. Les dents, ligne intermédiaire, servent souvent de niveau de stop pendant une tendance ; Williams utilisait aussi l’Alligator pour décider si une fractale devait être prise en compte (voir iFractals).
  • Filtre pour stratégie de range. À l’inverse, une stratégie de retour à la moyenne peut ne s’activer que pendant le sommeil de l’Alligator.

Limites et pièges

Trois moyennes lissées décalées vers le futur produisent un indicateur très lent : l’état « éveillé » est souvent confirmé quand une bonne partie du mouvement est déjà faite, et la sortie au « rendormissement » rend une part significative du gain. Les décalages compliquent aussi la lecture : un code qui mélange positions avec et sans décalage compare des valeurs calculées à des moments différents, sans aucune erreur visible. Le seuil d’ouverture en ATR est un paramètre supplémentaire ; s’il est optimisé finement, il risque de ne refléter que l’historique de test. Enfin, en marché agité sans direction, les lignes peuvent s’ordonner brièvement et déclencher un faux réveil. Pour la mise en œuvre d’un filtre combiné, voir Filtres horaires, de spread et de volatilité, et pour l’ensemble des indicateurs de tendance la rubrique Indicateurs en MQL5.

Un Alligator « éveillé » ne garantit pas que la tendance se poursuive ; les faux départs sont fréquents. Le code de cette page classe des états sans passer d’ordres. Testez toute stratégie construite dessus sur un long historique et sur compte de démonstration avant de l’utiliser en réel.

FAQ

Quels sont les buffers d’iAlligator ?

Le buffer 0 contient la mâchoire (GATORJAW_LINE), le buffer 1 les dents (GATORTEETH_LINE) et le buffer 2 les lèvres (GATORLIPS_LINE).

Quels réglages pour l’Alligator standard ?

Périodes et décalages 13/8, 8/5 et 5/3, méthode MODE_SMMA et prix PRICE_MEDIAN, comme dans l’exemple de la documentation officielle.

Comment lire les valeurs les plus récentes, sans décalage ?

Créez le handle avec des décalages à 0. Les buffers contiennent alors les moyennes lissées calculées sur la bougie lue, au lieu des valeurs affichées décalées.

Comment savoir si l’Alligator dort ?

Quand les trois lignes ne sont pas ordonnées (ni lèvres > dents > mâchoire, ni l’inverse), elles sont emmêlées : l’Alligator dort et le marché n’a pas de tendance nette.

A

Alix · fondateur d’OptiBot Trading

Développeur MQL5 et ProBuilder, spécialiste du backtest et de l’optimisation de stratégies automatiques. Chaque contenu est vérifié sur la documentation officielle (MQL5.com, manuels ProRealTime) et testé avant publication. Notre méthode éditoriale.