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

MQL5 · Indicateurs

iATR en MQL5 : mesurer la volatilité et dimensionner stop et volume

Lire l’ATR avec iATR, comprendre le True Range et transformer la volatilité en distance de stop et en volume de position cohérents avec le risque accepté par transaction.

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

iATR(symbole, unité de temps, période) crée un handle vers l’Average True Range, un indicateur à un seul buffer (index 0) qui mesure l’amplitude moyenne des bougies en unités de prix. Contrairement à la plupart des indicateurs, l’ATR ne sert presque jamais à décider du sens d’une position : dans un robot, il sert à dimensionner. Il fixe la distance du stop loss, la taille de la position, l’écart d’un trailing stop ou le seuil d’un filtre de volatilité. Cette page montre comment passer d’une valeur d’ATR à un volume en lots cohérent avec le risque que vous acceptez par transaction.

Ce que mesure l’ATR

L’ATR est la moyenne du True Range (TR). Selon l’aide de MetaTrader 5, le TR d’une bougie est la plus grande des trois valeurs suivantes :

  1. le plus haut moins le plus bas de la bougie ;
  2. l’écart entre la clôture précédente et le plus haut actuel ;
  3. l’écart entre la clôture précédente et le plus bas actuel.

Les deux derniers termes, pris en valeur absolue, intègrent les gaps : si le marché ouvre loin de la clôture précédente, le TR inclut ce saut alors que l’écart plus haut – plus bas l’ignorerait. L’ATR est ensuite une moyenne mobile de ces TR sur la période choisie (14 est la valeur habituelle).

Deux conséquences pour le code. L’ATR est exprimé dans l’unité du prix : environ 0,0008 sur un EURUSD en M15, plusieurs dollars sur l’or, plusieurs dizaines de points sur un indice. Et il ne contient aucune information de direction : un marché qui monte fortement et un marché qui baisse fortement ont le même ATR. L’aide de MT5 note qu’il atteint souvent des valeurs élevées après des baisses brutales et reste bas pendant les phases de consolidation.

La fonction iATR

int iATR(
   string          symbol,      // symbole, NULL = courant
   ENUM_TIMEFRAMES period,      // unité de temps, 0 = courante
   int             ma_period    // période de la moyenne
);

La fonction n’a pas de paramètre de prix appliqué, puisque le TR utilise toujours plus haut, plus bas et clôture précédente. Elle renvoie INVALID_HANDLE en cas d’échec. Le buffer unique se lit avec CopyBuffer(handle, 0, ...), selon le principe décrit dans Handles d’indicateurs et CopyBuffer.

De l’ATR à la taille de position

Le raisonnement tient en trois étapes.

  1. Distance du stop. Vous placez le stop à k fois l’ATR de la dernière bougie clôturée, par exemple 2 × ATR. La distance s’adapte ainsi à la volatilité : plus large quand le marché bouge beaucoup, plus serrée quand il est calme.
  2. Perte par lot. Une distance de prix se convertit en monnaie du compte grâce à deux propriétés du symbole : SYMBOL_TRADE_TICK_SIZE (la plus petite variation de prix) et SYMBOL_TRADE_TICK_VALUE (la valeur de cette variation pour un lot). Perte par lot = distance / taille du tick × valeur du tick.
  3. Volume. Volume = montant risqué / perte par lot, puis arrondi au pas de volume du symbole et borné par ses minimum et maximum.

Le résultat a une propriété importante : le montant perdu si le stop est touché reste à peu près constant, quelle que soit la volatilité. Quand l’ATR double, le stop s’éloigne et le volume est divisé par deux. La logique de risque elle-même (quel pourcentage risquer, pourquoi) est développée dans Risque par trade.

Exemple : un EA qui calcule stop et volume à partir de l’ATR

L’EA ci-dessous ne passe pas d’ordre ; il calcule, à chaque nouvelle bougie, la distance de stop et le volume qu’il faudrait utiliser pour risquer un pourcentage donné des fonds propres. Il est conçu pour être intégré à votre propre logique d’entrée.

input int    InpAtrPeriod = 14;    // période de l'ATR
input double InpAtrMult   = 2.0;   // stop = multiple de l'ATR
input double InpRiskPct   = 1.0;   // risque par transaction en % des fonds propres

int hAtr = INVALID_HANDLE;

int OnInit()
  {
   hAtr = iATR(_Symbol, _Period, InpAtrPeriod);
   return(hAtr == INVALID_HANDLE ? INIT_FAILED : INIT_SUCCEEDED);
  }

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

// Volume pour perdre 'riskMoney' si le prix parcourt 'stopDist' contre la position
double VolumeForRisk(double riskMoney, double stopDist)
  {
   double tickSize  = SymbolInfoDouble(_Symbol, SYMBOL_TRADE_TICK_SIZE);
   double tickValue = SymbolInfoDouble(_Symbol, SYMBOL_TRADE_TICK_VALUE);
   double volStep   = SymbolInfoDouble(_Symbol, SYMBOL_VOLUME_STEP);
   double volMin    = SymbolInfoDouble(_Symbol, SYMBOL_VOLUME_MIN);
   double volMax    = SymbolInfoDouble(_Symbol, SYMBOL_VOLUME_MAX);
   if(tickSize <= 0 || tickValue <= 0 || volStep <= 0 || stopDist <= 0) return(0.0);

   double lossPerLot = stopDist / tickSize * tickValue;    // perte pour 1 lot
   double vol = riskMoney / lossPerLot;
   vol = MathFloor(vol / volStep) * volStep;               // arrondi vers le bas au pas
   if(vol < volMin) return(0.0);                           // risque trop faible : on ne trade pas
   return(MathMin(vol, volMax));
  }

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

   double atr[];
   ArraySetAsSeries(atr, true);
   if(CopyBuffer(hAtr, 0, 0, 2, atr) < 2) return;
   lastBar = t;

   double stopDist  = InpAtrMult * atr[1];                       // ATR de la bougie clôturée
   double riskMoney = AccountInfoDouble(ACCOUNT_EQUITY) * InpRiskPct / 100.0;
   double vol       = VolumeForRisk(riskMoney, stopDist);
   int    digits    = (int)SymbolInfoInteger(_Symbol, SYMBOL_DIGITS);

   PrintFormat("ATR=%s  stop=%s  risque=%.2f  volume=%.2f",
               DoubleToString(atr[1], digits), DoubleToString(stopDist, digits),
               riskMoney, vol);
  }

Trois détails méritent attention. Le volume est arrondi vers le bas au pas du symbole : arrondir au plus proche pourrait dépasser le risque prévu. Si le volume calculé est inférieur au minimum du symbole, la fonction renvoie 0 plutôt que de forcer le volume minimum, qui ferait risquer plus que prévu. Enfin, la valeur du tick est donnée dans la devise du compte par le terminal, ce qui évite les conversions manuelles. La page Calculer et normaliser la taille de lot détaille les cas particuliers de la normalisation.

Choisir la période et le multiple

La période de l’ATR fixe l’horizon de volatilité pris en compte. Une période courte (5 à 10) suit de près les changements de rythme du marché, mais elle fait varier fortement la taille des positions d’une bougie à l’autre. Une période longue (20 à 50) donne un volume plus stable, au prix d’une adaptation plus lente après un choc. Le multiple du stop dépend surtout de la durée de détention visée : un système qui garde ses positions quelques bougies peut se contenter de 1 à 1,5 ATR, tandis qu’un suivi de tendance qui veut laisser respirer le marché utilise souvent 2 à 3 ATR. Le multiple et la période interagissent avec la logique d’entrée : changez-les ensemble avec prudence, et observez dans le rapport de test la distribution des pertes plutôt que le seul résultat net. Un multiple trop serré se reconnaît à une proportion anormale de positions coupées puis suivies d’un mouvement dans le sens prévu.

Pensez aussi à l’unité de temps de l’ATR. Rien n’oblige à utiliser celle du graphique : un EA en M5 peut calculer son stop sur un ATR H1, plus représentatif du bruit que la position devra traverser si elle dure plusieurs heures.

Autres usages de l’ATR dans un robot

  • Trailing stop. Suivre le prix à une distance de k × ATR, recalculée à chaque bougie, plutôt qu’à un nombre fixe de points.
  • Filtre de volatilité. Interdire les entrées quand l’ATR est inférieur à un multiple du spread : les coûts de transaction absorberaient alors l’essentiel du mouvement attendu.
  • Objectif de sortie. Un take profit à m × ATR garde un rapport constant avec le stop, quelle que soit la volatilité.
  • Normalisation d’autres indicateurs. Diviser un MACD, une pente de moyenne ou un écart au prix par l’ATR les rend comparables d’un symbole à l’autre.
  • Détection de régime. Comparer un ATR court à un ATR long indique si la volatilité est en expansion ou en contraction.

Limites et pièges

L’ATR est une moyenne du passé : il réagit avec retard à un changement brutal de volatilité, typiquement lors d’une annonce économique. Un stop à 2 × ATR calculé juste avant une publication peut être beaucoup trop serré pour la bougie suivante. L’ATR ne protège pas non plus contre les gaps du week-end, que le stop ne peut pas empêcher. Sur les unités de temps très courtes, l’ATR peut devenir comparable au spread, et un stop exprimé en ATR peut alors se retrouver sous la distance minimale imposée par le courtier (SYMBOL_TRADE_STOPS_LEVEL). Vérifiez ce cas avant d’envoyer l’ordre. Enfin, l’ATR d’une unité de temps ne se transpose pas à une autre : un ATR H1 n’est pas quatre fois un ATR M15. L’ensemble des autres indicateurs de volatilité est présenté dans la rubrique Indicateurs en MQL5.

Dimensionner une position avec l’ATR limite la perte prévue si le stop est exécuté au prix demandé, mais pas la perte réelle en cas de gap, de glissement ou de liquidité insuffisante. Le trading avec effet de levier peut entraîner des pertes rapides. Testez toujours votre calcul de volume sur un compte de démonstration.

FAQ

L’ATR est-il exprimé en points ou en prix ?

En prix. Pour l’obtenir en points, divisez-le par _Point. Pour le convertir en monnaie du compte, utilisez SYMBOL_TRADE_TICK_SIZE et SYMBOL_TRADE_TICK_VALUE comme dans l’exemple.

Quelle bougie d’ATR utiliser pour calculer un stop ?

La dernière bougie clôturée, d’indice 1. La valeur d’indice 0 évolue tant que la bougie en cours n’est pas terminée.

Pourquoi iATR n’a-t-il pas de paramètre applied_price ?

Le True Range utilise par définition le plus haut, le plus bas et la clôture précédente. Il n’y a pas de prix unique à choisir.

Que faire si le volume calculé est inférieur au minimum du symbole ?

Ne pas trader, ou réduire la distance du stop si votre stratégie le permet. Forcer le volume minimum ferait risquer davantage que le pourcentage prévu.

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.