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

MQL4 · Migration MQL5

Des fonctions iXXX aux handles : porter les indicateurs de MQL4 vers MQL5

En MQL4, iMA renvoie une valeur ; en MQL5, il renvoie un handle à lire avec CopyBuffer. Créer les handles dans OnInit, lire le bon buffer, porter iCustom : la méthode et les correspondances.

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

En MQL4, lire un indicateur tient en une ligne : double ma = iMA(Symbol(), 0, 50, 0, MODE_SMA, PRICE_CLOSE, 1); renvoie la valeur de la moyenne mobile sur la bougie d’indice 1. En MQL5, la même fonction iMA existe, mais elle ne renvoie pas une valeur : elle renvoie un handle, c’est-à-dire un identifiant entier de l’instance d’indicateur que le terminal crée et calcule. Les valeurs se lisent ensuite avec CopyBuffer, qui copie des éléments d’un des buffers de l’indicateur dans un tableau.

Ce changement oblige à réorganiser le code : on ne lit plus un indicateur « à la volée » au milieu d’une condition, on le crée une fois, puis on copie ses valeurs quand on en a besoin. Cette page explique la transformation, donne les correspondances des indicateurs les plus courants et signale les pièges.

Le principe en trois temps

  1. Créer le handle, une seule fois, dans OnInit(), et vérifier qu’il est différent de INVALID_HANDLE.
  2. Copier les valeurs avec CopyBuffer(handle, numéro_de_buffer, position_de_départ, nombre, tableau), qui renvoie le nombre d’éléments copiés ou -1 en cas d’erreur.
  3. Libérer le handle avec IndicatorRelease(handle) dans OnDeinit().

Le paramètre de décalage shift, qui terminait chaque appel MQL4, disparaît de la fonction iMA : il est remplacé par la position de départ de CopyBuffer. La position 0 désigne la bougie en cours, la position 1 la dernière bougie clôturée, comme le shift de MQL4. Le décalage graphique ma_shift, lui, existe toujours dans la signature de iMA.

Comparaison des signatures

IndicateurMQL4 (valeur directe)MQL5 (handle)Buffers MQL5
Moyenne mobileiMA(sym, tf, période, ma_shift, méthode, prix, shift)iMA(sym, tf, période, ma_shift, méthode, prix)0
RSIiRSI(sym, tf, période, prix, shift)iRSI(sym, tf, période, prix)0
MACDiMACD(sym, tf, rapide, lente, signal, prix, mode, shift)iMACD(sym, tf, rapide, lente, signal, prix)0 principale, 1 signal
Bandes de BollingeriBands(sym, tf, période, écart, bands_shift, prix, mode, shift)iBands(sym, tf, période, bands_shift, écart, prix)0 milieu, 1 haute, 2 basse
ATRiATR(sym, tf, période, shift)iATR(sym, tf, période)0
Indicateur personnaliséiCustom(sym, tf, nom, params..., mode, shift)iCustom(sym, tf, nom, params...)selon l’indicateur

Deux pièges se cachent dans ce tableau. Pour les indicateurs à plusieurs lignes, le paramètre mode de MQL4 (par exemple MODE_MAIN, MODE_SIGNAL, MODE_UPPER) devient le numéro de buffer passé à CopyBuffer. Et pour iBands, l’ordre des paramètres écart et bands_shift est inversé entre les deux langages : une traduction mécanique produit des bandes fausses sans aucune erreur de compilation. Vérifiez chaque signature dans la documentation de la version cible. Les paramètres MQL4 d’origine sont détaillés dans iMA en MQL4 et les autres pages de la rubrique Indicateurs MQL4.

Exemple de portage : croisement de moyennes et filtre RSI

//+------------------------------------------------------------------+
//| MQL4 : lecture directe des indicateurs                           |
//+------------------------------------------------------------------+
int SignalMql4()
  {
   double fast1 = iMA(Symbol(), 0, 20, 0, MODE_EMA, PRICE_CLOSE, 1);
   double slow1 = iMA(Symbol(), 0, 50, 0, MODE_EMA, PRICE_CLOSE, 1);
   double fast2 = iMA(Symbol(), 0, 20, 0, MODE_EMA, PRICE_CLOSE, 2);
   double slow2 = iMA(Symbol(), 0, 50, 0, MODE_EMA, PRICE_CLOSE, 2);
   double rsi1  = iRSI(Symbol(), 0, 14, PRICE_CLOSE, 1);

   if(fast2 <= slow2 && fast1 > slow1 && rsi1 < 70) return  1;   // achat
   if(fast2 >= slow2 && fast1 < slow1 && rsi1 > 30) return -1;   // vente
   return 0;
  }
//+------------------------------------------------------------------+
//| MQL5 : handles créés une fois, valeurs copiées à la demande      |
//+------------------------------------------------------------------+
int g_fast = INVALID_HANDLE, g_slow = INVALID_HANDLE, g_rsi = INVALID_HANDLE;

int OnInit()
  {
   g_fast = iMA(_Symbol, _Period, 20, 0, MODE_EMA, PRICE_CLOSE);
   g_slow = iMA(_Symbol, _Period, 50, 0, MODE_EMA, PRICE_CLOSE);
   g_rsi  = iRSI(_Symbol, _Period, 14, PRICE_CLOSE);
   if(g_fast == INVALID_HANDLE || g_slow == INVALID_HANDLE || g_rsi == INVALID_HANDLE)
     {
      Print("Création des indicateurs impossible, erreur ", GetLastError());
      return INIT_FAILED;
     }
   return INIT_SUCCEEDED;
  }

void OnDeinit(const int reason)
  {
   IndicatorRelease(g_fast);
   IndicatorRelease(g_slow);
   IndicatorRelease(g_rsi);
  }

int SignalMql5()
  {
   double fast[], slow[], rsi[];
   ArraySetAsSeries(fast, true);          // index 0 = bougie la plus récente copiée
   ArraySetAsSeries(slow, true);
   ArraySetAsSeries(rsi,  true);

   // deux valeurs à partir de la bougie 1 : fast[0] = bougie 1, fast[1] = bougie 2
   if(CopyBuffer(g_fast, 0, 1, 2, fast) != 2) return 0;
   if(CopyBuffer(g_slow, 0, 1, 2, slow) != 2) return 0;
   if(CopyBuffer(g_rsi,  0, 1, 1, rsi)  != 1) return 0;

   if(fast[1] <= slow[1] && fast[0] > slow[0] && rsi[0] < 70) return  1;
   if(fast[1] >= slow[1] && fast[0] < slow[0] && rsi[0] > 30) return -1;
   return 0;
  }

void OnTick() { }

L’appel à ArraySetAsSeries est essentiel pour conserver la logique d’indexation de MQL4 : sans lui, le tableau est indexé du plus ancien au plus récent, et fast[0] désignerait la bougie 2 au lieu de la bougie 1. Le test du nombre d’éléments copiés protège contre les situations où l’indicateur n’est pas encore calculé, par exemple au démarrage du terminal ou juste après le chargement de l’historique.

Une fonction d’aide pour garder un code lisible

Le principal reproche fait au modèle MQL5 est sa verbosité : là où MQL4 tenait en une ligne, il faut déclarer un tableau, l’indexer en série, appeler CopyBuffer et tester le retour. Une petite fonction d’aide redonne au code la lisibilité de l’original. Par exemple, une fonction double Buf(const int handle, const int buffer, const int shift) qui copie une seule valeur dans un tableau d’un élément et renvoie EMPTY_VALUE en cas d’échec permet d’écrire Buf(g_fast, 0, 1) à la place de iMA(..., 1). La logique de l’EA garde alors exactement la même forme dans les deux langages, ce qui facilite la relecture et la comparaison.

Cette approche a un coût : une copie par valeur lue. Pour quelques valeurs par tick, il est négligeable. Pour une boucle qui lit des centaines de valeurs, préférez une seule copie de toute la plage dans un tableau, puis parcourez ce tableau.

Vérifier que les valeurs concordent

Avant de comparer des backtests, comparez des valeurs. Placez la version MQL4 et la version MQL5 sur le même symbole et la même période, et affichez avec Print les valeurs des indicateurs sur les mêmes bougies clôturées. Des écarts minimes peuvent venir des données des deux serveurs, en particulier si les historiques ne commencent pas au même endroit : les moyennes exponentielles et le RSI dépendent de toutes les bougies passées. Un écart important, en revanche, signale presque toujours un mauvais paramètre, un mauvais numéro de buffer ou un décalage d’indice.

Porter iCustom

En MQL4, iCustom reçoit les paramètres de l’indicateur, puis le numéro de buffer (mode) et le décalage. En MQL5, il reçoit seulement les paramètres et renvoie un handle ; le numéro de buffer est passé à CopyBuffer. Mais surtout, l’indicateur appelé doit exister en version MQL5 : un .ex4 n’est pas utilisable. Si vous n’avez pas le code source de l’indicateur, le portage de l’EA est bloqué tant qu’il n’est pas réécrit. Vérifiez aussi que l’indicateur porté expose ses buffers dans le même ordre que l’original.

Pièges fréquents

  • Créer le handle dans OnTick : la pratique recommandée est de créer chaque handle une seule fois ; le recréer à chaque tick ajoute un travail inutile au terminal et complique la libération des ressources.
  • Valeur vide : un buffer peut contenir EMPTY_VALUE sur les bougies où l’indicateur n’a pas de valeur (fractales, flèches). Testez cette valeur comme en MQL4.
  • Multi-périodes : lire une moyenne en H4 depuis un graphique M15 exige un handle créé avec PERIOD_H4. Les données de l’autre période peuvent ne pas être prêtes au premier appel : testez le retour de CopyBuffer.
  • Ordre des paramètres : comparez chaque appel à la signature MQL5 ; le cas de iBands n’est pas le seul où une traduction mot à mot est trompeuse.

Le fonctionnement complet des handles et de CopyBuffer est détaillé dans la page MQL5 Handles d’indicateurs et CopyBuffer. Pour les autres chantiers de la migration, revenez à la rubrique Migrer de MQL4 vers MQL5, ou consultez [Remplacer Close[] et Time[]](/mql4/migration-mql5/tableaux-de-series-mql5/) pour l’accès aux prix.

Une erreur d’indice ou de paramètre dans la lecture d’un indicateur produit des signaux différents de l’original sans aucun message d’erreur. Comparez les valeurs lues par les deux versions sur les mêmes bougies avant tout test en réel. Le trading comporte un risque de perte en capital.

Questions fréquentes

Pourquoi iMA renvoie-t-il un entier en MQL5 ?

Parce qu’il renvoie un handle, l’identifiant de l’instance d’indicateur créée par le terminal. Les valeurs de la moyenne se lisent ensuite avec CopyBuffer.

Où créer les handles d’indicateurs ?

Dans OnInit(), une seule fois, en vérifiant que chaque handle est différent de INVALID_HANDLE. Libérez-les dans OnDeinit() avec IndicatorRelease().

Comment retrouver le paramètre shift de MQL4 ?

Avec la position de départ de CopyBuffer : 0 pour la bougie en cours, 1 pour la dernière bougie clôturée. Utilisez ArraySetAsSeries sur le tableau de destination pour garder l’indexation habituelle.

Que devient le paramètre mode des indicateurs à plusieurs lignes ?

Il devient le numéro de buffer passé à CopyBuffer. Pour le MACD, par exemple, le buffer 0 contient la ligne principale et le buffer 1 la ligne de signal.

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.