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

MQL5 · Indicateurs

iIchimoku en MQL5 : cinq buffers et lecture des lignes décalées

Lire les cinq lignes de l’Ichimoku avec iIchimoku, comprendre le décalage du nuage et de la Chikou, et éviter les erreurs d’indexation dans un Expert Advisor.

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

iIchimoku(symbole, unité de temps, tenkan_sen, kijun_sen, senkou_span_b) crée un handle vers l’Ichimoku Kinko Hyo de MetaTrader 5, un indicateur à cinq buffers : 0 pour Tenkan-sen, 1 pour Kijun-sen, 2 pour Senkou Span A, 3 pour Senkou Span B et 4 pour Chikou Span. La difficulté propre à l’Ichimoku n’est pas le nombre de lignes, mais leur décalage dans le temps : le nuage est projeté vers le futur et la Chikou vers le passé. Lire ces buffers sans tenir compte de ces décalages conduit à comparer le prix à de mauvaises valeurs. Cette page explique comment le terminal stocke ces lignes et comment les lire correctement dans un robot.

Les cinq lignes et leur calcul

L’aide de MetaTrader 5 décrit les lignes ainsi (les périodes par défaut du terminal sont 9, 26 et 52) :

  • Tenkan-sen : (plus haut + plus bas) / 2 sur la première période (9 bougies). Une ligne de milieu de range court, non décalée.
  • Kijun-sen : le même calcul sur la deuxième période (26 bougies), non décalé.
  • Senkou Span A : (Tenkan-sen + Kijun-sen) / 2, tracée en avant de la longueur de la Kijun (26 bougies).
  • Senkou Span B : le milieu du range sur la troisième période (52 bougies), tracé lui aussi 26 bougies en avant.
  • Chikou Span : la clôture courante, tracée en arrière de 26 bougies.

L’espace entre Senkou A et Senkou B forme le nuage (kumo). Selon l’aide, un prix au-dessus du nuage fait de la ligne haute du nuage un premier support et de la ligne basse un second ; un prix sous le nuage inverse les rôles ; un prix dans le nuage indique un marché sans tendance.

Remarquez que toutes les lignes sauf la Chikou sont des milieux de range, et non des moyennes de clôtures. Elles réagissent par paliers : la Kijun reste plate tant que le plus haut et le plus bas des 26 dernières bougies ne changent pas, ce qui en fait un niveau de référence naturel pour un stop.

La fonction iIchimoku

int iIchimoku(
   string          symbol,          // symbole, NULL = courant
   ENUM_TIMEFRAMES period,          // unité de temps, 0 = courante
   int             tenkan_sen,      // période de Tenkan-sen
   int             kijun_sen,       // période de Kijun-sen
   int             senkou_span_b    // période de Senkou Span B
);
BufferConstanteLigneDécalage d’affichage
0TENKANSEN_LINETenkan-senaucun
1KIJUNSEN_LINEKijun-senaucun
2SENKOUSPANA_LINESenkou Span Avers le futur
3SENKOUSPANB_LINESenkou Span Bvers le futur
4CHIKOUSPAN_LINEChikou Spanvers le passé

La fonction renvoie INVALID_HANDLE en cas d’échec. Il n’y a pas de paramètre de décalage : il découle de la période kijun_sen.

Lire correctement les lignes décalées

L’exemple de la documentation officielle d’iIchimoku donne la clé. Pour les buffers 2 et 3, il appelle CopyBuffer() avec une position de départ négative, égale à moins le décalage (-kijun_sen), afin de récupérer aussi la partie du nuage projetée dans le futur. Pour le buffer 4, il copie depuis la position 0 en précisant en commentaire que les données de la Chikou sont déjà stockées avec leur décalage dans iIchimoku.

Concrètement, pour un robot :

  • Le nuage sous la bougie courante se lit à la position 0 ou 1 des buffers 2 et 3, comme n’importe quel indicateur : c’est la valeur affichée à l’aplomb de cette bougie, calculée 26 bougies plus tôt.
  • Le nuage futur, celui que le graphique affiche à droite de la dernière bougie, se lit avec une position de départ négative. En copiant depuis -kijun_sen, l’élément le plus récent du tableau correspond à la projection la plus lointaine.
  • La Chikou est la clôture déplacée de 26 bougies vers la gauche. Plutôt que de manipuler son buffer, il est plus simple et plus sûr de reproduire sa règle directement : comparer la clôture de la dernière bougie à la clôture d’il y a 26 bougies, avec iClose().

Vérifier votre indexation en deux minutes

Avant d’écrire la moindre règle, faites afficher par votre EA les valeurs de Senkou A et B pour la dernière bougie clôturée, puis comparez-les à la fenêtre de données du terminal (Ctrl+D) en survolant cette même bougie. Faites de même pour la projection la plus lointaine, en survolant l’extrémité droite du nuage. Si les chiffres concordent, votre lecture des positions négatives est correcte ; sinon, l’écart vous indique de combien de bougies votre index est décalé. Ce contrôle est indispensable chaque fois que vous changez la période Kijun, puisque le décalage en dépend.

Exemple : un EA qui décrit la situation Ichimoku

L’EA suivant calcule, sur la dernière bougie clôturée, quatre informations : position du prix par rapport au nuage, croisement Tenkan/Kijun, couleur du nuage projeté en fin de projection, et confirmation de type Chikou.

input int InpTenkan = 9;    // période Tenkan-sen
input int InpKijun  = 26;   // période Kijun-sen (et décalage)
input int InpSenkou = 52;   // période Senkou Span B

int hIchi = INVALID_HANDLE;

int OnInit()
  {
   hIchi = iIchimoku(_Symbol, _Period, InpTenkan, InpKijun, InpSenkou);
   return(hIchi == INVALID_HANDLE ? INIT_FAILED : INIT_SUCCEEDED);
  }

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

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

   double tenkan[], kijun[], spanA[], spanB[];
   ArraySetAsSeries(tenkan, true);
   ArraySetAsSeries(kijun,  true);
   ArraySetAsSeries(spanA,  true);
   ArraySetAsSeries(spanB,  true);

   // Lignes non décalées : positions 0 à 2
   if(CopyBuffer(hIchi, TENKANSEN_LINE, 0, 3, tenkan) < 3) return;
   if(CopyBuffer(hIchi, KIJUNSEN_LINE,  0, 3, kijun)  < 3) return;

   // Nuage : on part de -InpKijun pour inclure la projection future.
   // Indexation série : [0] = projection la plus lointaine,
   // [InpKijun] = bougie courante, [InpKijun + 1] = dernière bougie clôturée.
   int n = InpKijun + 2;
   if(CopyBuffer(hIchi, SENKOUSPANA_LINE, -InpKijun, n, spanA) < n) return;
   if(CopyBuffer(hIchi, SENKOUSPANB_LINE, -InpKijun, n, spanB) < n) return;
   lastBar = t;

   double close1  = iClose(_Symbol, _Period, 1);
   double closeK  = iClose(_Symbol, _Period, 1 + InpKijun);    // équivalent de la Chikou
   int    i1      = InpKijun + 1;                              // dernière bougie clôturée dans spanA/spanB
   double cloudHi = MathMax(spanA[i1], spanB[i1]);
   double cloudLo = MathMin(spanA[i1], spanB[i1]);

   string pos = (close1 > cloudHi) ? "au-dessus du nuage" :
                (close1 < cloudLo) ? "sous le nuage" : "dans le nuage";

   bool tkUp   = tenkan[2] <= kijun[2] && tenkan[1] > kijun[1];
   bool tkDown = tenkan[2] >= kijun[2] && tenkan[1] < kijun[1];

   string future = (spanA[0] > spanB[0]) ? "haussier" : "baissier";   // nuage projeté
   string chikou = (close1 > closeK) ? "confirme la hausse" : "confirme la baisse";

   PrintFormat("Prix %s | TK %s | nuage futur %s | Chikou %s",
               pos, tkUp ? "croisement haussier" : (tkDown ? "croisement baissier" : "-"),
               future, chikou);
  }

Le point délicat est l’indexation des tableaux du nuage : comme la copie part d’une position négative, l’indice de la dernière bougie clôturée n’est plus 1 mais InpKijun + 1. Commentez toujours ce décalage dans votre code ; il est invisible à la relecture. Pour le principe général des positions de départ et du sens des tableaux, voir Handles d’indicateurs et CopyBuffer et ArraySetAsSeries et indexation des séries.

Usages en trading algorithmique

  • Filtre de tendance. N’acheter que lorsque la clôture est au-dessus du nuage, ne vendre qu’en dessous, et ne rien faire dans le nuage. C’est l’usage le plus robuste, car il ne dépend que d’une comparaison simple.
  • Signal Tenkan/Kijun. L’aide de MT5 présente le croisement haussier de Tenkan au-dessus de Kijun comme un signal d’achat. Filtré par la position du prix par rapport au nuage, il devient un système complet de suivi de tendance.
  • Stop sur la Kijun. Comme la Kijun est un milieu de range sur 26 bougies, elle évolue par paliers ; elle sert de stop suiveur naturel, sans paramètre supplémentaire. Sa mise en œuvre rejoint la page Coder un trailing stop.
  • Épaisseur du nuage. L’écart entre Senkou A et Senkou B, rapporté à l’ATR, mesure la solidité de la zone de support ou de résistance.

Limites et pièges

L’Ichimoku a été conçu pour des données journalières, avec des périodes liées à un calendrier de cotation qui n’existe plus ; sur des unités de temps intraday, les valeurs 9, 26 et 52 n’ont pas de justification particulière. Comme toutes les lignes sont des milieux de range, l’indicateur est lent et produit de nombreux signaux contradictoires en marché horizontal, où le prix traverse le nuage à répétition. La multiplicité des conditions possibles (nuage, croisement, Chikou, couleur du nuage futur) invite à les combiner toutes, ce qui réduit fortement le nombre de transactions et rend les statistiques de backtest fragiles. Enfin, une erreur d’indexation sur les lignes décalées ne produit aucune erreur de compilation : vérifiez systématiquement vos valeurs en mode visuel dans le testeur. Les autres indicateurs de tendance sont présentés dans la rubrique Indicateurs en MQL5.

L’Ichimoku, comme tout indicateur de tendance, subit des séries de pertes en marché sans direction. Le code de cette page décrit une situation, il ne passe pas d’ordres et ne constitue pas une stratégie. Validez toute règle en backtest et en démonstration avant tout usage réel.

FAQ

Quels sont les numéros de buffers d’iIchimoku ?

0 pour Tenkan-sen, 1 pour Kijun-sen, 2 pour Senkou Span A, 3 pour Senkou Span B et 4 pour Chikou Span.

Comment lire le nuage projeté dans le futur ?

Copiez les buffers 2 et 3 avec une position de départ négative égale à moins la période Kijun, comme dans l’exemple de la documentation officielle. L’élément le plus récent du tableau correspond alors à la projection la plus lointaine.

Pourquoi ne pas lire directement le buffer de la Chikou ?

Ses données sont déjà stockées avec leur décalage vers le passé, ce qui rend l’indexation peu intuitive. Comparer la dernière clôture à la clôture d’il y a kijun_sen bougies reproduit la même information plus simplement.

Faut-il garder les périodes 9, 26 et 52 ?

Ce sont les valeurs d’origine, pensées pour des données journalières. Vous pouvez les adapter, mais gardez des proportions cohérentes entre elles et validez le choix hors échantillon.

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.