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

MQL4 · Bases

Tableaux de séries en MQL4 : Close[], High[], Time[] et iClose()

Open[], High[], Low[], Close[], Time[] : comment lire l’historique des bougies en MQL4, éviter le piège de la bougie 0 et interroger un autre symbole avec iClose, iTime et iBarShift.

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

En MQL4, les tableaux de séries Open[], High[], Low[], Close[], Time[] et Volume[] donnent un accès direct à l’historique des bougies du graphique courant. Ils sont indexés à l’envers : l’indice 0 désigne la bougie en cours de formation, l’indice 1 la dernière bougie clôturée, et ainsi de suite jusqu’à Bars - 1, la plus ancienne. Pour un autre symbole ou une autre unité de temps, on utilise les fonctions iOpen(), iHigh(), iLow(), iClose(), iTime() et iVolume(), qui prennent le symbole, l’unité de temps et le décalage en paramètres.

Cette page montre comment lire ces séries sans erreur, comment éviter le piège de la bougie 0 et comment rechercher un plus haut ou retrouver une bougie à partir d’une date. Elle fait partie de la rubrique Les bases du MQL4.

Comprendre l’indexation inversée

Dans un tableau classique, l’élément 0 est le premier inséré. Dans un tableau de séries, c’est l’inverse : le terminal place toujours la bougie la plus récente à l’indice 0 et décale les autres lorsqu’une nouvelle bougie s’ouvre. Ainsi, Close[1] désigne toujours « la clôture de la bougie précédente », quel que soit le moment où vous lisez la valeur.

ExpressionSignification
Close[0]Dernier prix de la bougie en cours (il change à chaque tick)
Close[1]Clôture de la dernière bougie terminée
High[5]Plus haut de la sixième bougie en partant de la plus récente
Time[0]Heure d’ouverture de la bougie en cours
BarsNombre total de bougies disponibles sur le graphique

Time[] contient des valeurs datetime, c’est-à-dire un nombre de secondes depuis le 1er janvier 1970. Volume[] contient le volume en ticks de chaque bougie (le nombre de variations de prix reçues), pas un volume réel échangé.

Le piège de la bougie 0

La bougie 0 n’est pas terminée : son Close[0] est égal au dernier Bid, son High[0] et son Low[0] peuvent encore évoluer. Un signal calculé sur la bougie 0 peut donc apparaître puis disparaître au cours de la même bougie. C’est l’origine de nombreux écarts entre un backtest et le comportement réel.

La règle la plus simple : calculez vos signaux sur les bougies clôturées (indice 1 et suivants) et ne déclenchez l’analyse qu’une fois par bougie, en surveillant Time[0]. Si votre stratégie a réellement besoin du prix courant (sortie sur seuil, par exemple), utilisez explicitement Bid et documentez ce choix.

Exemple complet : cassure du plus haut des 20 dernières bougies

L’EA suivant détecte, une fois par bougie, si la dernière bougie clôturée a fermé au-dessus du plus haut des 20 bougies précédentes. Il illustre Time[0], Close[1], iHighest() et le contrôle de Bars.

#property strict

input int InpPeriode = 20;          // Nombre de bougies pour le plus haut

datetime g_derniereBougie = 0;

void OnTick()
  {
   // 1. une seule analyse par bougie
   if(Time[0] == g_derniereBougie)
      return;
   g_derniereBougie = Time[0];

   // 2. vérifier que l'historique est suffisant
   if(Bars < InpPeriode + 2)
      return;

   // 3. indice du plus haut parmi les bougies 2 à InpPeriode+1
   int idx = iHighest(Symbol(), Period(), MODE_HIGH, InpPeriode, 2);
   if(idx < 0)
     {
      PrintFormat("iHighest a échoué, erreur %d", GetLastError());
      return;
     }
   double plusHaut = High[idx];

   // 4. la bougie clôturée (indice 1) casse-t-elle ce plus haut ?
   if(Close[1] > plusHaut)
      PrintFormat("Cassure : clôture %s > plus haut %s (bougie du %s)",
                  DoubleToString(Close[1], Digits),
                  DoubleToString(plusHaut, Digits),
                  TimeToString(Time[idx]));
  }

iHighest() renvoie un indice, pas un prix : on lit ensuite le prix dans High[]. Le dernier paramètre (2) indique l’indice de départ de la recherche, ce qui exclut la bougie en cours et celle que l’on teste. iLowest() fonctionne de la même façon avec MODE_LOW.

Lire un autre symbole ou une autre unité de temps

Les tableaux Close[] et consorts ne décrivent que le graphique sur lequel le programme tourne. Pour lire la clôture journalière d’hier depuis un graphique M15, ou le prix du GBPUSD depuis un graphique EURUSD, on utilise les fonctions de séries :

double clotureHier = iClose(Symbol(), PERIOD_D1, 1);     // clôture D1 d'hier
datetime ouvH1     = iTime("GBPUSD", PERIOD_H1, 0);      // ouverture de la bougie H1 en cours
int nbBougiesH4    = iBars(Symbol(), PERIOD_H4);         // historique disponible en H4
int idxLundi       = iBarShift(Symbol(), PERIOD_H1, D'2026.10.26 08:00', false);

iBarShift() fait le chemin inverse : à partir d’une date, il renvoie l’indice de la bougie correspondante. Avec le dernier paramètre à false, il renvoie la bougie la plus proche si aucune ne commence exactement à cette heure ; avec true, il renvoie -1 dans ce cas.

Point important : les données d’une autre unité de temps ou d’un autre symbole ne sont pas forcément chargées en mémoire au moment de l’appel. Le terminal lance alors leur téléchargement et la fonction peut renvoyer 0. Vérifiez donc toujours la valeur obtenue (une clôture à 0 n’a pas de sens) et, si besoin, retentez au tick suivant plutôt que de prendre une décision sur une donnée vide.

Les tableaux de séries dans vos propres tableaux

Vous pouvez donner à vos propres tableaux le même sens d’indexation avec ArraySetAsSeries(tableau, true). C’est utile lorsque vous copiez une portion d’historique ou remplissez un tampon de calcul et souhaitez garder la convention « 0 = plus récent ». Pensez-y aussi quand vous passez un tableau à une fonction de calcul comme iMAOnArray() : un tableau mal orienté produit des résultats inversés sans aucun message d’erreur.

Parcourir l’historique avec une boucle

Beaucoup de calculs maison (moyenne, plus haut sur une période, comptage de bougies haussières) reposent sur une boucle for qui lit les séries. Deux conventions évitent la plupart des erreurs. D’abord, faites varier l’indice de 1 vers le passé, jamais à partir de 0, pour ne travailler que sur des bougies terminées. Ensuite, bornez la boucle par le minimum entre la période souhaitée et Bars - 1, de sorte qu’elle ne sorte jamais du tableau, même sur un graphique dont l’historique est court.

Gardez aussi en tête le coût de ces boucles. Recalculer une moyenne sur 500 bougies à chaque tick est inutile : le résultat ne change qu’à l’ouverture d’une nouvelle bougie. Placez ces calculs dans le bloc exécuté une fois par bougie (le test sur Time[0] vu plus haut) et conservez le résultat dans une variable globale. Pour les indicateurs classiques, préférez les fonctions intégrées comme iMA() ou iATR(), plus rapides et déjà testées, plutôt qu’une réécriture manuelle.

Erreurs fréquentes

  • Dépassement de tableau. Lire Close[Bars] ou un indice supérieur provoque, en #property strict, une erreur critique « array out of range » qui arrête le programme. Testez toujours Bars ou iBars() avant une boucle sur l’historique.
  • Mémoriser un indice. L’indice d’une bougie change à chaque nouvelle bougie. Pour retrouver une bougie plus tard, stockez son Time[], puis recalculez l’indice avec iBarShift().
  • Confondre Volume et volume réel. Sur le forex, MetaTrader 4 fournit un volume de ticks, pas un volume de transactions.
  • Mélanger unités de temps. Close[1] sur un graphique H1 n’est pas la clôture d’hier. Pour une autre unité de temps, utilisez iClose() avec la période voulue.

Et en MQL5 ?

MQL5 ne fournit pas de tableaux Close[] ou Time[] prédéfinis. On copie l’historique dans ses propres tableaux avec CopyClose(), CopyTime() ou CopyRates() (qui remplit des structures MqlRates), et l’on choisit l’orientation avec ArraySetAsSeries(). Les fonctions iClose(), iTime() et iBarShift() existent aussi dans les versions récentes de MQL5. La page [Remplacer Close[] et Time[]](/mql4/migration-mql5/tableaux-de-series-mql5/) détaille la conversion, et l’utilisation de ces séries dans les indicateurs est abordée dans la rubrique Indicateurs MQL4.

FAQ

Pourquoi Close[0] change-t-il sans arrêt ?

Parce que la bougie 0 est en cours de formation : sa clôture est le dernier prix reçu. Utilisez Close[1] pour travailler sur une bougie terminée.

Comment détecter l’ouverture d’une nouvelle bougie ?

Mémorisez Time[0] dans une variable globale et comparez-la à chaque tick. Quand la valeur change, une nouvelle bougie vient de s’ouvrir.

iClose renvoie 0, que faire ?

Les données de ce symbole ou de cette unité de temps ne sont probablement pas encore chargées. Vérifiez GetLastError(), n’exploitez pas la valeur nulle et réessayez au tick suivant ; ouvrir une fois le graphique concerné accélère le chargement.

Bars et iBars donnent-ils le même résultat ?

Pour le symbole et l’unité de temps du graphique, oui. iBars() permet en plus d’interroger n’importe quel couple symbole et unité de temps.

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.