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

MQL5 · Indicateurs

iVolumes en MQL5 : lire le volume et construire un filtre de volume relatif

iVolumes() donne le volume en ticks ou réel de chaque bougie. Signature, pièges de la bougie en cours et de la saisonnalité, et code complet d’un filtre de volume relatif.

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

iVolumes() renvoie un handle vers l’indicateur Volumes de MetaTrader 5, celui qui affiche un histogramme vert et rouge sous le graphique. Son buffer 0 contient le volume de chaque bougie, en ticks ou en volume réel selon le paramètre choisi. Dans un robot, ce n’est presque jamais le volume brut qui est utile, mais le volume relatif : le volume de la dernière bougie close comparé à ce qui est normal pour cet instrument. C’est l’objet de cette page.

Signature et paramètres

int iVolumes(
   string               symbol,          // symbole, NULL = courant
   ENUM_TIMEFRAMES      period,          // unité de temps, 0 = courante
   ENUM_APPLIED_VOLUME  applied_volume   // VOLUME_TICK ou VOLUME_REAL
   );

La documentation précise que l’indicateur n’a qu’un seul buffer. La fonction renvoie INVALID_HANDLE si la création échoue ; libérez le handle avec IndicatorRelease() dans OnDeinit().

Une remarque sur l’exemple de la documentation officielle : l’indicateur d’exemple déclare deux buffers (DRAW_COLOR_HISTOGRAM avec un buffer de couleur) et copie aussi un « buffer 1 » depuis le handle iVolumes, alors que le texte de la page affirme qu’il n’y a qu’un buffer. Dans votre code, tenez-vous-en au buffer 0 et recalculez la couleur vous-même si vous en avez besoin. La règle est simple et figure dans l’aide du terminal : la barre est verte quand le volume de la bougie est supérieur à celui de la précédente, rouge quand il est inférieur.

Quel volume lit-on vraiment ?

Pour le forex, l’aide de MetaTrader 5 décrit Volumes comme le nombre de changements de prix pendant la bougie : c’est le volume en ticks (VOLUME_TICK). Il ne mesure pas des lots échangés, mais l’activité du flux de cotations du courtier. En pratique, il est fortement corrélé à l’activité réelle du marché, ce qui le rend exploitable, mais ses valeurs absolues n’ont aucun sens d’un serveur à l’autre.

VOLUME_REAL correspond au volume échangé et n’a de contenu que lorsque le serveur le transmet, typiquement pour des contrats à terme ou des actions. Si votre robot doit fonctionner sur plusieurs symboles, prévoyez un paramètre pour choisir le type de volume, et vérifiez au démarrage qu’il ne renvoie pas uniquement des zéros.

Une alternative à l’indicateur existe : le tableau tick_volume[] est fourni directement à OnCalculate() dans un indicateur personnalisé (voir OnCalculate et prev_calculated). iVolumes() reste la solution la plus simple dans un Expert Advisor, et la seule qui permette de lire une autre unité de temps ou un autre symbole avec le même code de copie de buffer que les autres indicateurs.

Le piège de la bougie en cours

Le volume de la bougie en cours (index 0 en indexation série) augmente tout au long de sa formation. Comparé à des bougies complètes, il paraît toujours faible au début et ne devient comparable qu’à la clôture. Un filtre du type « volume courant supérieur à la moyenne » est donc presque toujours faux en début de bougie et presque toujours vrai à la fin, ce qui crée un biais temporel caché dans vos résultats.

Deux solutions propres :

  • travailler uniquement sur la dernière bougie close (index 1), à l’ouverture de chaque nouvelle bougie ;
  • ou, si vous avez besoin d’une lecture en cours de bougie, normaliser le volume par la fraction de temps écoulée, en sachant que l’activité n’est pas uniforme à l’intérieur d’une bougie.

La première solution suffit dans l’immense majorité des cas.

Exemple complet : un filtre de volume relatif

Le code suivant calcule le ratio entre le volume de la dernière bougie close et la moyenne des InpAvgBars bougies précédentes. Un ratio de 2 signifie que la bougie a été deux fois plus active que la normale récente. L’Expert Advisor l’utilise comme filtre : il ne journalise une cassure du plus haut récent que si elle s’accompagne d’un volume relatif suffisant.

//+------------------------------------------------------------------+
//| RelativeVolume.mq5 - cassure confirmée par le volume relatif     |
//+------------------------------------------------------------------+
input ENUM_APPLIED_VOLUME InpVolume   = VOLUME_TICK; // type de volume
input int                 InpAvgBars  = 20;          // bougies pour la moyenne
input double              InpMinRatio = 1.5;         // volume relatif minimal
input int                 InpRange    = 20;          // fenêtre du plus haut

int hVol = INVALID_HANDLE;

int OnInit()
  {
   hVol = iVolumes(_Symbol, PERIOD_CURRENT, InpVolume);
   if(hVol == INVALID_HANDLE)
     {
      PrintFormat("iVolumes : échec, erreur %d", GetLastError());
      return(INIT_FAILED);
     }
   return(INIT_SUCCEEDED);
  }

void OnDeinit(const int reason)
  {
   if(hVol != INVALID_HANDLE)
      IndicatorRelease(hVol);
  }

//--- volume de la bougie 1 divisé par la moyenne des bougies 2..InpAvgBars+1
//--- renvoie -1 si les données ne sont pas disponibles
double RelativeVolume()
  {
   double vol[];
   ArraySetAsSeries(vol, true);
   int need = InpAvgBars + 2;
   if(CopyBuffer(hVol, 0, 0, need, vol) < need)
      return(-1.0);

   double sum = 0.0;
   for(int i = 2; i < need; i++)
      sum += vol[i];
   double avg = sum / InpAvgBars;
   if(avg <= 0.0)                     // volume nul : impossible de comparer
      return(-1.0);
   return(vol[1] / avg);
  }

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

   double ratio = RelativeVolume();
   if(ratio < 0.0) return;

   //--- cassure : la clôture de la bougie 1 dépasse le plus haut des bougies 2..InpRange+1
   double high[], close[];
   ArraySetAsSeries(high, true);
   ArraySetAsSeries(close, true);
   if(CopyHigh(_Symbol, PERIOD_CURRENT, 0, InpRange + 2, high) < InpRange + 2) return;
   if(CopyClose(_Symbol, PERIOD_CURRENT, 0, 2, close) < 2) return;

   double hh = high[2];
   for(int i = 3; i < InpRange + 2; i++)
      hh = MathMax(hh, high[i]);

   if(close[1] > hh)
      PrintFormat("%s : cassure à %s, volume relatif %.2f (%s)", _Symbol,
                  DoubleToString(close[1], _Digits), ratio,
                  ratio >= InpMinRatio ? "confirmée" : "rejetée");
  }

Le garde-fou avg <= 0.0 n’est pas décoratif : sur un symbole sans volume réel, la moyenne est nulle et la division provoquerait une erreur d’exécution. La page Division par zéro explique pourquoi ce type d’erreur arrête un programme MQL5. Le motif « une évaluation par nouvelle bougie » est détaillé dans Détecter une nouvelle bougie.

La saisonnalité intrajournalière du volume

Le volume en ticks suit un profil horaire très marqué : faible pendant la session asiatique sur les paires européennes, en forte hausse à l’ouverture de Londres, puis de nouveau à l’ouverture américaine. Une moyenne glissante sur les 20 dernières bougies M15 mélange donc des heures calmes et des heures actives. À 9 h, presque toutes les bougies paraissent « à fort volume » simplement parce que la moyenne contient la nuit.

Si votre stratégie est sensible à ce biais, comparez plutôt chaque bougie aux bougies de la même heure des jours précédents. Sur un graphique M15, cela revient à prendre les bougies situées 96, 192, 288… positions plus loin, en tenant compte des week-ends et des jours fériés, où le décalage n’est plus régulier. L’approche la plus sûre consiste à repérer les bougies par leur heure d’ouverture plutôt que par un décalage fixe. Ce sujet rejoint la question plus large des effets saisonniers et horaires.

Lire le volume d’une unité de temps supérieure

Le deuxième paramètre de iVolumes() permet de lire le volume d’une autre unité de temps que celle du graphique. Un robot qui travaille en M5 peut ainsi vérifier que la dernière bougie H1 close a été plus active que la moyenne des bougies H1 précédentes, ce qui donne un contexte plus stable qu’une lecture bougie par bougie en M5. Créez simplement un second handle avec PERIOD_H1 dans OnInit(). Deux précautions : l’index 1 de ce handle désigne la dernière bougie H1 close, et non la bougie M5 précédente ; et au premier appel, les données H1 peuvent ne pas être encore construites, d’où l’importance de vérifier le nombre d’éléments renvoyé par CopyBuffer() avant de calculer quoi que ce soit.

Autres usages en trading algorithmique

  • Filtre d’horaires implicite. Exiger un volume relatif minimal évite naturellement les périodes creuses, sans coder d’horaires fixes. Pour un filtre explicite, voyez Filtres horaires, de spread et de volatilité.
  • Détection d’événements. Un volume relatif très élevé (5 ou 10 fois la normale) signale souvent une publication économique ; certains robots suspendent alors leurs entrées.
  • Contrôle de la qualité des données. Une série de volumes nuls au milieu de l’historique trahit souvent un trou de données dans le testeur.

Pour un indicateur qui transforme le volume en tendance cumulée, voyez iOBV ; la liste complète des fonctions d’indicateurs se trouve sur la page Indicateurs en MQL5.

Un filtre de volume réduit le nombre de signaux mais ne garantit pas leur qualité. Testez-le sur le flux de données du courtier que vous utiliserez réellement, car le volume en ticks varie d’un serveur à l’autre, et validez en démo avant tout engagement de capital.

FAQ

Le volume en ticks est-il un vrai volume ?

Non : il compte le nombre de changements de prix pendant la bougie, pas les quantités échangées. Il reflète bien l’activité relative du marché, mais ses valeurs absolues dépendent du courtier et ne se comparent pas d’un serveur à l’autre.

Comment retrouver la couleur verte ou rouge de l’histogramme ?

Comparez le volume de la bougie à celui de la précédente : vert s’il est supérieur, rouge s’il est inférieur, selon l’aide de MetaTrader 5. Lisez le buffer 0 sur deux bougies et faites la comparaison vous-même.

Pourquoi mon filtre de volume se déclenche-t-il surtout en fin de bougie ?

Parce que vous lisez la bougie en cours, dont le volume augmente jusqu’à la clôture. Basez le filtre sur la dernière bougie close (index 1 en indexation série).

iVolumes ou tick_volume[] dans OnCalculate ?

Dans un indicateur personnalisé qui travaille sur le graphique courant, tick_volume[] est déjà disponible. Dans un Expert Advisor, ou pour une autre unité de temps, iVolumes() et CopyBuffer() sont plus directs.

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.