MQL5 · Indicateurs
iAMA en MQL5 : la moyenne adaptative de Kaufman et son ratio d’efficacité
iAMA() calcule une moyenne mobile qui accélère en tendance et ralentit en range. Rôle des trois périodes, ratio d’efficacité recalculé et code complet de filtre de régime.
iAMA() donne accès à l’Adaptive Moving Average de Perry Kaufman, une moyenne mobile qui change de vitesse toute seule : elle suit le prix de près quand le marché avance de façon directionnelle, et ralentit fortement quand il oscille sans direction. La fonction prend sept paramètres, dont trois périodes qui n’ont pas le même rôle, et renvoie un handle à un seul buffer (index 0). Cette page explique ce que règle chaque période, comment recalculer le « ratio d’efficacité » qui pilote l’indicateur, et comment s’en servir comme filtre de régime dans un robot.
Signature et rôle des sept paramètres
int iAMA(
string symbol, // symbole, NULL = courant
ENUM_TIMEFRAMES period, // unité de temps, 0 = courante
int ama_period, // période du ratio d'efficacité
int fast_ma_period, // période rapide (marché directionnel)
int slow_ma_period, // période lente (absence de tendance)
int ama_shift, // décalage horizontal
ENUM_APPLIED_PRICE applied_price // prix appliqué ou handle d'un indicateur
);
La documentation définit ainsi les trois périodes : ama_period est la période sur laquelle est calculé le coefficient d’efficacité ; fast_ma_period est la période rapide utilisée pour le coefficient de lissage quand le marché est rapide ; slow_ma_period est la période lente utilisée en l’absence de tendance. L’exemple de la documentation utilise 15, 2 et 30, avec un décalage nul. La fonction renvoie INVALID_HANDLE en cas d’échec ; libérez le handle avec IndicatorRelease().
L’erreur la plus fréquente consiste à traiter ces trois périodes comme interchangeables, ou à les optimiser toutes ensemble. Elles ont des rôles distincts :
| Paramètre | Ce qu’il règle | Effet d’une augmentation |
|---|---|---|
ama_period | La fenêtre sur laquelle on juge si le marché est directionnel | Jugement plus stable, réaction plus tardive aux changements de régime |
fast_ma_period | La vitesse maximale, atteinte en tendance parfaite | AMA plus lente même en tendance forte |
slow_ma_period | La vitesse minimale, en marché sans direction | AMA encore plus immobile en range |
Le mécanisme : ratio d’efficacité et constante de lissage
L’aide de MetaTrader 5 décrit le calcul en trois étapes.
- Le ratio d’efficacité :
ER = Signal / Bruit, où le signal est la valeur absolue de la variation du prix sur N bougies,|Price(i) - Price(i-N)|, et le bruit la somme des valeurs absolues des variations bougie par bougie sur la même fenêtre. N correspond àama_period. - La constante de lissage : elle est interpolée entre une constante rapide,
2 / (fast + 1), et une constante lente,2 / (slow + 1), en fonction de l’ER :SSC = ER × (rapide - lente) + lente. Avec 2 et 30, la constante rapide vaut 0,6667 et la lente 0,0645. - La mise à jour :
AMA(i) = AMA(i-1) + SSC² × (Price(i) - AMA(i-1)).
Le ratio d’efficacité est un nombre entre 0 et 1. Il vaut 1 quand le prix a avancé en ligne droite (tout le chemin parcouru a servi à progresser) et tend vers 0 quand le prix a beaucoup bougé pour revenir au même point. Le carré de la constante de lissage accentue l’effet : en range, la moyenne devient presque horizontale ; en tendance nette, elle colle au prix.
Exemple complet : recalculer l’ER et l’utiliser avec la pente de l’AMA
L’intérêt de recalculer le ratio d’efficacité dans votre code est double : vérifier que vous comprenez ce que fait l’indicateur, et disposer d’une mesure explicite du régime de marché, utilisable comme filtre indépendant. Le robot ci-dessous lit l’AMA, calcule l’ER sur les clôtures avec la même période, et ne signale une tendance que lorsque les deux mesures concordent.
//+------------------------------------------------------------------+
//| AmaRegime.mq5 - pente de l'AMA + ratio d'efficacité de Kaufman |
//+------------------------------------------------------------------+
input int InpErPeriod = 15; // ama_period (fenêtre de l'ER)
input int InpFast = 2; // période rapide
input int InpSlow = 30; // période lente
input double InpMinEr = 0.30; // ER minimal pour parler de tendance
input int InpSlopeBars = 3; // bougies pour mesurer la pente
int hAma = INVALID_HANDLE;
int OnInit()
{
hAma = iAMA(_Symbol, PERIOD_CURRENT, InpErPeriod, InpFast, InpSlow, 0, PRICE_CLOSE);
if(hAma == INVALID_HANDLE)
{
PrintFormat("iAMA : échec, erreur %d", GetLastError());
return(INIT_FAILED);
}
return(INIT_SUCCEEDED);
}
void OnDeinit(const int reason)
{
if(hAma != INVALID_HANDLE)
IndicatorRelease(hAma);
}
//--- ratio d'efficacité calculé sur les clôtures, bougie close 1 incluse
double EfficiencyRatio(int n)
{
double c[];
ArraySetAsSeries(c, true);
if(CopyClose(_Symbol, PERIOD_CURRENT, 1, n + 1, c) != n + 1)
return(-1.0); // données indisponibles
double signal = MathAbs(c[0] - c[n]); // déplacement net
double noise = 0.0;
for(int i = 0; i < n; i++)
noise += MathAbs(c[i] - c[i + 1]); // chemin parcouru
if(noise <= 0.0)
return(0.0); // prix figé : aucune efficacité
return(signal / noise);
}
void OnTick()
{
static datetime lastBar = 0;
datetime bar = iTime(_Symbol, PERIOD_CURRENT, 0);
if(bar == lastBar) return;
double ama[];
ArraySetAsSeries(ama, true);
if(CopyBuffer(hAma, 0, 1, InpSlopeBars + 1, ama) != InpSlopeBars + 1) return;
double er = EfficiencyRatio(InpErPeriod);
if(er < 0.0) return;
lastBar = bar;
double slope = (ama[0] - ama[InpSlopeBars]) / _Point; // en points
string regime = (er >= InpMinEr) ? "directionnel" : "sans direction";
if(er >= InpMinEr && slope > 0.0)
PrintFormat("%s : tendance haussière (ER %.2f, pente %.0f pts)", _Symbol, er, slope);
else if(er >= InpMinEr && slope < 0.0)
PrintFormat("%s : tendance baissière (ER %.2f, pente %.0f pts)", _Symbol, er, slope);
else
PrintFormat("%s : marché %s, ER %.2f : pas de signal", _Symbol, regime, er);
}
Le calcul de l’ER copie n + 1 clôtures à partir de la bougie 1 : il faut une valeur de plus que la période pour obtenir n variations. Le cas noise <= 0 couvre un prix strictement figé, rare mais possible sur un symbole peu actif ou pendant une coupure de flux. La pente est mesurée sur plusieurs bougies et exprimée en points, ce qui la rend lisible dans le journal ; pour comparer plusieurs symboles, divisez-la plutôt par un ATR.
Pourquoi un ER bas n’est pas « un mauvais marché »
Un ratio d’efficacité faible signifie que le prix fait beaucoup de chemin pour peu de progression. Pour un système de suivi de tendance, c’est un environnement défavorable, où l’AMA reste plate et où les croisements avec le prix sont des faux signaux. Pour un système de retour à la moyenne, c’est au contraire le terrain recherché. L’ER est donc moins un filtre « bon/mauvais » qu’un aiguillage : il permet à un même robot d’activer des logiques différentes selon le régime, ou à un portefeuille de robots de savoir lequel est dans son élément. La page Stratégies de suivi de tendance développe cette notion de régime.
Réglages : par où commencer
Partez des valeurs de l’exemple officiel (15, 2, 30) et ne modifiez qu’un paramètre à la fois. Dans la plupart des cas, c’est ama_period qui mérite d’être adapté à l’unité de temps : il fixe l’horizon sur lequel vous jugez qu’une tendance existe. Les périodes rapide et lente définissent des bornes de vitesse ; les modifier change peu la logique, mais beaucoup le nombre de signaux. Méfiez-vous des optimisations qui proposent des combinaisons exotiques (rapide à 7, lente à 11, par exemple) : elles vident l’indicateur de son caractère adaptatif, puisque les deux bornes deviennent proches. La page Optimisation génétique donne des pistes pour encadrer ces recherches.
Pièges spécifiques
- Le seuil d’ER dépend de l’unité de temps. Sur des bougies courtes, le bruit est plus important et l’ER moyen plus faible. Un seuil de 0,3 adapté au H4 sera rarement atteint en M5.
- L’AMA « plate » n’est pas une AMA « neutre ». En range, elle reste au niveau où elle s’est arrêtée, parfois loin du prix actuel. Un croisement prix/AMA dans ce contexte n’a pas de signification de tendance.
- Le décalage
ama_shift. Il sert à l’affichage ; dans un robot, laissez-le à 0 pour garder des index simples. - Les gaps. Un gap de week-end ajoute un grand déplacement en une seule variation, ce qui gonfle à la fois le signal et le bruit, et peut faire bondir l’ER de façon trompeuse pendant
ama_periodbougies.
Pour comparer avec d’autres moyennes à faible retard, voyez iDEMA et iTEMA ou iFrAMA, qui s’adapte lui aussi au marché, mais à partir d’une mesure de dimension fractale. L’ensemble des moyennes et oscillateurs est présenté sur la page Indicateurs en MQL5.
FAQ
À quoi sert ama_period dans iAMA ?
C’est la fenêtre sur laquelle est calculé le ratio d’efficacité, c’est-à-dire le rapport entre le déplacement net du prix et le chemin total parcouru. Plus elle est longue, plus le jugement « tendance ou pas » est stable et tardif.
Quelles valeurs par défaut utiliser pour iAMA ?
L’exemple de la documentation MQL5 utilise 15 pour ama_period, 2 pour la période rapide, 30 pour la période lente et un décalage de 0. C’est un bon point de départ.
Pourquoi l’AMA reste-t-elle presque horizontale ?
Parce que le ratio d’efficacité est faible : le marché oscille sans direction nette, la constante de lissage tend vers la valeur lente et, élevée au carré, elle rend la moyenne très lente.
Combien de buffers possède iAMA ?
Un seul, d’index 0, qui contient la valeur de la moyenne adaptative. Le ratio d’efficacité n’est pas exposé : il faut le recalculer, comme dans l’exemple de cette page.
- 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
- iAlligator
- iFractals
- iOBV : On Balance Volume
- iMFI : Money Flow Index
- iVolumes
- iStdDev : écart-type
- iDeMarker
- iBearsPower et iBullsPower
- iForce
- iOsMA
- iRVI
- 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)
