MQL4 · Indicateurs
iATR en MQL4 : mesurer la volatilité pour placer ses stops
iATR renvoie l’Average True Range en unités de prix. Signature, conversion en points, stop loss et taille de position fondés sur l’ATR, filtre de volatilité et pièges courants en MQL4.
iATR() renvoie en MQL4 la valeur de l’Average True Range, la moyenne de l’amplitude réelle des bougies, pour la bougie désignée par shift. La valeur est exprimée en unités de prix : 0.00085 sur EURUSD signifie environ 8,5 pips, 12.4 sur l’or signifie 12,4 dollars par once. La fonction est l’une des plus simples de MQL4, avec seulement quatre paramètres et aucune ligne à choisir, mais c’est aussi l’une des plus utiles dans un Expert Advisor : elle permet d’adapter le stop loss, le take profit et la taille de position à la volatilité réelle du marché au lieu d’utiliser des distances fixes.
La signature de iATR
double iATR(
string symbol, // symbole, NULL = symbole courant
int timeframe, // unité de temps, 0 = celle du graphique
int period, // nombre de bougies moyennées (14)
int shift // bougie lue : 0 = en cours, 1 = dernière clôturée
);
Il n’y a pas de prix appliqué : le *true range* d’une bougie est par définition le plus grand écart entre le haut, le bas et la clôture précédente. Le détail du calcul est présenté sur la page iATR en MQL5. Côté MQL4, retenez qu’une seule lecture par bougie suffit dans la plupart des cas.
Convertir l’ATR en points
Les fonctions de trading de MQL4 attendent des prix, mais les paramètres d’un EA sont souvent exprimés en points. Pour passer de l’un à l’autre, divisez par la variable prédéfinie Point, qui vaut la plus petite variation de prix du symbole (0.00001 sur une paire à cinq décimales, 0.01 sur une paire en yen à trois décimales). La page Variables prédéfinies (Bid, Ask, Point, Digits) détaille ces variables.
double atr = iATR(NULL, 0, 14, 1); // ATR de la dernière bougie clôturée
double atrPoints = atr / Point; // même valeur exprimée en points
Print("ATR 14 = ", DoubleToString(atr, Digits), " soit ", DoubleToString(atrPoints, 0), " points");
Pensez à normaliser tout prix calculé à partir de l’ATR avec NormalizeDouble(prix, Digits) avant de l’envoyer au serveur : un prix avec trop de décimales peut être refusé.
Exemple complet : stop et volume proportionnels à l’ATR
Cet exemple montre la technique la plus répandue : placer le stop à un multiple de l’ATR, puis calculer le volume pour que la perte au stop corresponde à un pourcentage fixe du solde. Le signal d’entrée est volontairement trivial (cassure du plus haut de la bougie précédente) pour mettre l’accent sur la gestion du risque. La conversion d’une distance en volume via MODE_TICKVALUE et MODE_TICKSIZE est expliquée plus en détail dans Taille de lot selon le risque.
#property strict
input int PeriodeATR = 14;
input double MultStop = 2.0; // stop = 2 x ATR
input double MultObjectif = 3.0; // objectif = 3 x ATR
input double RisquePct = 1.0; // risque par trade en % du solde
input int Magic = 41005;
datetime derniereBougie = 0;
void OnTick()
{
if(Time[0] == derniereBougie) return;
derniereBougie = Time[0];
if(OrdresEA() > 0) return;
double atr = iATR(NULL, 0, PeriodeATR, 1);
if(atr <= 0) return; // historique insuffisant
// Signal d'exemple : la bougie 1 a clôturé au-dessus du plus haut de la bougie 2
if(Close[1] <= High[2]) return;
double distanceStop = MultStop * atr;
double lots = VolumePourRisque(distanceStop);
if(lots <= 0) return;
double sl = NormalizeDouble(Ask - distanceStop, Digits);
double tp = NormalizeDouble(Ask + MultObjectif * atr, Digits);
if(OrderSend(Symbol(), OP_BUY, lots, Ask, 3, sl, tp, "ATR", Magic, 0, clrBlue) < 0)
Print("OrderSend : erreur ", GetLastError());
}
// Volume tel que la perte au stop = RisquePct % du solde
double VolumePourRisque(double distancePrix)
{
double tickValue = MarketInfo(Symbol(), MODE_TICKVALUE);
double tickSize = MarketInfo(Symbol(), MODE_TICKSIZE);
double pas = MarketInfo(Symbol(), MODE_LOTSTEP);
double minLot = MarketInfo(Symbol(), MODE_MINLOT);
double maxLot = MarketInfo(Symbol(), MODE_MAXLOT);
if(tickValue <= 0 || tickSize <= 0 || pas <= 0) return(0);
double risqueArgent = AccountBalance() * RisquePct / 100.0;
double pertePar1Lot = distancePrix / tickSize * tickValue;
double lots = MathFloor(risqueArgent / pertePar1Lot / pas) * pas;
if(lots < minLot) return(0); // risque trop faible pour ce stop
return(MathMin(lots, maxLot));
}
int OrdresEA()
{
int n = 0;
for(int i = OrdersTotal() - 1; i >= 0; i--)
if(OrderSelect(i, SELECT_BY_POS, MODE_TRADES)
&& OrderSymbol() == Symbol() && OrderMagicNumber() == Magic) n++;
return(n);
}
Notez que la fonction renvoie 0 plutôt que le lot minimal quand le volume calculé est trop petit : arrondir à la hausse dépasserait le risque prévu. Avec ce schéma, le risque monétaire par trade reste constant alors que le stop s’élargit ou se resserre avec la volatilité.
Filtrer les marchés trop calmes ou trop agités
L’ATR sert aussi de filtre. Un marché dont l’ATR actuel est très inférieur à sa moyenne de long terme offre peu d’amplitude, et le spread pèse alors lourd dans le résultat. À l’inverse, un ATR très supérieur à la normale accompagne souvent une publication économique ou un choc, avec des écarts de prix importants. Une règle simple consiste à comparer l’ATR court à un ATR long :
double atrCourt = iATR(NULL, 0, 14, 1);
double atrLong = iATR(NULL, 0, 100, 1);
bool volatiliteNormale = (atrLong > 0 && atrCourt > 0.7 * atrLong && atrCourt < 2.0 * atrLong);
Les coefficients 0,7 et 2,0 ne sont que des points de départ : ils dépendent de l’instrument et de l’unité de temps.
Pourquoi l’ATR plutôt qu’une distance fixe
Un stop de 30 pips n’a pas le même sens en période calme, quand une bougie H1 parcourt 10 pips, et un jour d’annonce de banque centrale, quand elle en parcourt 60. Dans le premier cas, le stop est très éloigné du bruit normal et le ratio gain/risque se dégrade ; dans le second, il sera touché par une simple oscillation. En exprimant le stop en multiple de l’ATR, vous gardez une distance constante par rapport au bruit du marché, quel que soit le régime de volatilité.
Cette approche a une conséquence directe sur le volume : si le stop s’élargit, le volume doit diminuer pour que la perte potentielle reste identique en argent. C’est exactement ce que fait la fonction VolumePourRisque() de l’exemple. Sans cet ajustement, un stop en ATR augmenterait le risque pris dans les phases agitées, c’est-à-dire au pire moment.
Le même raisonnement s’applique aux objectifs de gain. Un take profit à trois fois l’ATR reste atteignable dans un marché calme comme dans un marché agité, alors qu’un objectif fixe de 50 pips peut devenir hors de portée pendant des semaines lorsque la volatilité retombe. Pour comparer les résultats d’un même EA sur plusieurs symboles, exprimer toutes les distances en ATR est également la manière la plus simple d’obtenir des paramètres transposables d’un marché à l’autre, même si chaque symbole garde ses particularités.
Pièges fréquents
- Confondre points et pips : sur une paire à cinq décimales, 1 pip = 10 points. Un paramètre « 20 » interprété en points au lieu de pips donne un stop dix fois trop serré.
- ATR de la bougie 0 : en début de bougie, son *true range* est petit, ce qui tire l’ATR vers le bas. Utilisez le shift 1 pour un dimensionnement stable.
- Stop trop proche : sur un marché calme,
2 × ATRpeut être inférieur au niveau de stop minimal du courtier. Comparez la distance àMarketInfo(Symbol(), MODE_STOPLEVEL) * Pointavant d’envoyer l’ordre. - Unité de temps du robot : un ATR lu sur M5 pour un EA qui garde ses positions plusieurs jours sous-estime fortement les variations à encaisser. Lisez l’ATR de l’unité de temps correspondant à la durée de vos trades.
Les autres indicateurs de la plateforme sont présentés dans la rubrique Indicateurs en MQL4.
FAQ
Dans quelle unité iATR renvoie-t-il sa valeur ?
Dans l’unité de prix du symbole. Divisez par Point pour obtenir des points, et tenez compte du nombre de décimales pour convertir en pips.
Quelle période d’ATR choisir ?
La période 14 proposée par J. Welles Wilder est la plus utilisée. Une période plus courte réagit plus vite aux changements de volatilité, une période plus longue donne une mesure plus stable, adaptée au dimensionnement des positions.
Pourquoi mon calcul de lot renvoie zéro ?
Soit l’ATR est nul (historique insuffisant), soit le volume nécessaire est inférieur au lot minimal du symbole pour le risque demandé. Augmentez le pourcentage de risque ou réduisez le multiple d’ATR, après avoir vérifié l’impact sur la stratégie.
L’ATR indique-t-il la direction du marché ?
Non. L’ATR mesure uniquement l’amplitude des mouvements, sans distinguer hausse et baisse. Un ATR qui augmente peut accompagner une forte hausse comme une forte baisse ; il faut un autre indicateur pour juger de la direction.
Peut-on lire l’ATR quotidien depuis un graphique H1 ?
Oui, avec iATR(NULL, PERIOD_D1, 14, 1). La valeur donne l’amplitude moyenne d’une journée, utile pour fixer un objectif ou vérifier qu’il reste assez de « course » dans la séance. Vérifiez que l’historique D1 est chargé.
Peut-on utiliser l’ATR pour un stop suiveur ?
Oui : à chaque nouvelle bougie, recalculez un stop à une distance de N × ATR du plus haut atteint et rapprochez le stop existant avec OrderModify si le nouveau niveau est plus favorable. Ne reculez jamais le stop.
