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.
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 :
| Ligne | Couleur | Calcul | Décalage |
|---|---|---|---|
| Mâchoire (jaw) | bleue | SMMA(prix médian, 13) | 8 bougies vers le futur |
| Dents (teeth) | rouge | SMMA(prix médian, 8) | 5 bougies vers le futur |
| Lèvres (lips) | verte | SMMA(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
);
| Buffer | Constante | Ligne |
|---|---|---|
| 0 | GATORJAW_LINE | mâchoire |
| 1 | GATORTEETH_LINE | dents |
| 2 | GATORLIPS_LINE | lè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 :
- 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.
- 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_UPouGATOR_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.
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.
- Handles d’indicateurs et CopyBuffer
- iMA : moyennes mobiles
- iRSI : Relative Strength Index
- iMACD
- iBands : bandes de Bollinger
- iATR : Average True Range
- iStochastic
- iADX
- iCCI
- iMomentum
- iIchimoku
- iSAR : Parabolic SAR
- iEnvelopes
- iWPR : Williams %R
- iAO : Awesome Oscillator
- iAC : Accelerator Oscillator
- iFractals
- iOBV : On Balance Volume
- iMFI : Money Flow Index
- iVolumes
- iStdDev : écart-type
- iDeMarker
- iBearsPower et iBullsPower
- iForce
- iOsMA
- iRVI
- iAMA : moyenne mobile adaptative
- iDEMA et iTEMA
- iFrAMA
- iCustom : appeler un indicateur personnalisé
- Créer un indicateur personnalisé
- Buffers et styles de tracé
- OnCalculate et prev_calculated
- Indicateur multi-timeframe
- Objets graphiques (ObjectCreate)
