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

MQL4 · Indicateurs

iIchimoku en MQL4 : lire les cinq lignes et le nuage

iIchimoku renvoie Tenkan-sen, Kijun-sen, Senkou Span A et B ou Chikou Span selon le paramètre mode. Signature, constantes numérotées à partir de 1, lignes décalées dans le temps et EA commenté.

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

iIchimoku() renvoie en MQL4 la valeur d’une des cinq lignes de l’Ichimoku Kinko Hyo pour la bougie désignée par shift : Tenkan-sen, Kijun-sen, Senkou Span A, Senkou Span B ou Chikou Span. La ligne se choisit avec le paramètre mode, et c’est ici qu’apparaît la première particularité : les constantes de l’Ichimoku sont numérotées à partir de 1, de MODE_TENKANSEN (1) à MODE_CHIKOUSPAN (5), alors que la plupart des autres indicateurs commencent à 0. La seconde particularité est plus subtile : trois lignes sur cinq sont dessinées décalées dans le temps, ce qui rend la lecture du nuage piégeuse dans un Expert Advisor. Cette page détaille ces deux points et propose un exemple complet.

La signature de iIchimoku

double iIchimoku(
   string symbol,          // symbole, NULL = symbole courant
   int    timeframe,       // unité de temps, 0 = celle du graphique
   int    tenkan_sen,      // période de la Tenkan-sen (9)
   int    kijun_sen,       // période de la Kijun-sen (26)
   int    senkou_span_b,   // période de la Senkou Span B (52)
   int    mode,            // ligne : MODE_TENKANSEN (1) ... MODE_CHIKOUSPAN (5)
   int    shift            // bougie lue : 0 = en cours, 1 = dernière clôturée
);
ConstanteValeurLigne
MODE_TENKANSEN1ligne de conversion, milieu de la fourchette sur 9 bougies
MODE_KIJUNSEN2ligne de base, milieu de la fourchette sur 26 bougies
MODE_SENKOUSPANA3première borne du nuage, moyenne de Tenkan et Kijun
MODE_SENKOUSPANB4seconde borne du nuage, milieu de la fourchette sur 52 bougies
MODE_CHIKOUSPAN5ligne retardée, la clôture reportée dans le passé

L’exemple de la documentation officielle lit la Tenkan-sen de la bougie précédente avec iIchimoku(NULL, 0, 9, 26, 52, MODE_TENKANSEN, 1). La construction de chaque ligne et l’interprétation globale de l’indicateur sont présentées sur la page iIchimoku en MQL5.

Le piège des constantes numérotées à partir de 1

Si vous avez l’habitude d’écrire 0 pour la ligne principale d’un MACD ou d’un stochastique, vous serez tenté de lire la Tenkan-sen avec mode = 0. Or 0 ne correspond à aucune ligne de l’Ichimoku dans la liste ci-dessus. Le code compile, l’appel renvoie une valeur, et l’erreur peut passer inaperçue longtemps. La règle est simple : n’écrivez jamais de nombre pour le paramètre mode, utilisez toujours la constante nommée.

Les lignes décalées : ce que vous lisez vraiment

Sur le graphique, la Senkou Span A et la Senkou Span B sont projetées vers le futur d’un nombre de bougies égal à la période de la Kijun-sen (26 par défaut), et la Chikou Span est reportée vers le passé du même nombre de bougies. C’est ce qui donne au nuage son allure caractéristique, dessiné en avance sur le prix.

Le shift d’iIchimoku() désigne la position dans la série calculée par l’indicateur, pas forcément la bougie au-dessus de laquelle la valeur est dessinée. Dans l’indicateur Ichimoku fourni avec MetaTrader 4, la valeur de Senkou Span lue au shift 1 est celle calculée sur la bougie 1, qui apparaît à l’écran 26 bougies plus à droite. Pour connaître le nuage situé sous la bougie 1, il faut lire la valeur calculée 26 bougies plus tôt, c’est-à-dire au shift 1 + kijun_sen.

Ce comportement dépend de la façon dont l’indicateur gère ses décalages ; vérifiez-le vous-même avant de bâtir une stratégie dessus. La méthode la plus sûre consiste à imprimer les valeurs lues pour plusieurs shifts avec Print(), puis à les comparer à la fenêtre des données (Ctrl+D) en survolant la bougie concernée. Une vérification de cinq minutes évite des semaines de backtests faux.

// Vérification : comparer ces valeurs avec la fenêtre des données
int kijun = 26;
double spanA_calc   = iIchimoku(NULL, 0, 9, kijun, 52, MODE_SENKOUSPANA, 1);
double spanA_dessous = iIchimoku(NULL, 0, 9, kijun, 52, MODE_SENKOUSPANA, 1 + kijun);
Print("Span A calculée sur la bougie 1 : ", spanA_calc,
      " / Span A affichée sous la bougie 1 (à vérifier) : ", spanA_dessous);

La même prudence vaut pour la Chikou Span. Comme elle reporte la clôture dans le passé, la valeur la plus récente n’est connue qu’avec un retard équivalent ; dans un robot, il est souvent plus simple et plus transparent de comparer directement Close[1] au prix de 26 bougies plus tôt, Close[1 + 26], ce qui revient à la même information.

Exemple complet : prix au-dessus du nuage et croisement Tenkan / Kijun

L’EA ci-dessous achète lorsque la Tenkan-sen croise au-dessus de la Kijun-sen sur des bougies clôturées et que la clôture se situe au-dessus du nuage affiché sous la bougie 1. Le décalage du nuage est géré par une fonction dédiée, qu’il vous suffira d’ajuster si votre vérification donne un résultat différent.

#property strict

input int    Tenkan     = 9;
input int    Kijun      = 26;
input int    SenkouB    = 52;
input int    StopPoints = 500;
input double Lots       = 0.10;
input int    Magic      = 41009;

datetime derniereBougie = 0;

double Ichi(int ligne, int shift)
{
   return(iIchimoku(NULL, 0, Tenkan, Kijun, SenkouB, ligne, shift));
}

// Haut et bas du nuage dessiné sous la bougie 'shift'
void Nuage(int shift, double &haut, double &bas)
{
   double a = Ichi(MODE_SENKOUSPANA, shift + Kijun);
   double b = Ichi(MODE_SENKOUSPANB, shift + Kijun);
   haut = MathMax(a, b);
   bas  = MathMin(a, b);
}

void OnTick()
{
   if(Time[0] == derniereBougie) return;
   derniereBougie = Time[0];
   if(Bars < SenkouB + Kijun + 10) return;           // historique insuffisant

   double t1 = Ichi(MODE_TENKANSEN, 1), t2 = Ichi(MODE_TENKANSEN, 2);
   double k1 = Ichi(MODE_KIJUNSEN, 1),  k2 = Ichi(MODE_KIJUNSEN, 2);
   double hautNuage, basNuage;
   Nuage(1, hautNuage, basNuage);

   bool croisement = (t2 <= k2 && t1 > k1);
   bool auDessus   = (Close[1] > hautNuage);
   if(!(croisement && auDessus) || OrdresEA() > 0) return;

   double sl = NormalizeDouble(Ask - StopPoints * Point, Digits);
   if(OrderSend(Symbol(), OP_BUY, Lots, Ask, 3, sl, 0, "Ichimoku", Magic, 0, clrBlue) < 0)
      Print("OrderSend : erreur ", GetLastError());
}

int OrdresEA()
{
   int n = 0;
   for(int i = OrdersTotal() - 1; i >= 0; i--)
      if(OrderSelect(i, SELECT_BY_POS, MODE_TRADES)
         && OrderSymbol() == Symbol() && OrderMagicNumber() == Magic) n++;
   return(n);
}

La condition Bars < SenkouB + Kijun + 10 évite de lire des valeurs alors que l’historique ne couvre pas encore la période de la Senkou Span B augmentée du décalage. La variable prédéfinie Bars donne le nombre de bougies disponibles sur le graphique ; les séries de prix et leur indexation sont détaillées dans [Tableaux de séries (Close[], Time[])](/mql4/bases/tableaux-de-series/).

Paramètres : 9, 26, 52 ou autre chose ?

Les périodes 9, 26 et 52 ont été conçues au Japon pour des graphiques journaliers, à une époque où la semaine de bourse comptait six jours : 9 correspondait à une semaine et demie, 26 à un mois, 52 à deux mois. Elles sont restées la norme et la plupart des traders les utilisent sur toutes les unités de temps. Rien n’interdit de les modifier, mais l’Ichimoku possède déjà trois périodes : les optimiser toutes ensemble multiplie le risque de sur-ajustement. Si vous les changez, gardez au moins leurs proportions et faites-le pour une raison argumentée plutôt que pour améliorer un backtest.

Usages et pièges en trading

  • Le nuage comme filtre : la position du prix par rapport au nuage est la lecture la plus robuste de l’Ichimoku. Elle se prête bien à un rôle de filtre de tendance pour d’autres signaux.
  • Nuage fin : quand Span A et Span B sont très proches, le nuage n’apporte presque aucune information. Exigez une épaisseur minimale, par exemple rapportée à l’ATR, avant de l’utiliser comme support ou résistance.
  • Croisements Tenkan / Kijun : ils sont fréquents en range, comme tous les croisements de lignes calculées sur des fenêtres courtes. Ne les utilisez pas seuls.
  • Kijun comme stop : la Kijun-sen est une référence naturelle pour un stop suiveur, car elle représente le milieu de la fourchette récente. Elle peut être lue à chaque nouvelle bougie et comparée au stop actuel.
  • Unités de temps supérieures : si vous lisez l’Ichimoku en D1 depuis un graphique H1, le décalage du nuage s’exprime en bougies D1, pas en bougies H1.

Retrouvez les autres indicateurs de tendance dans la rubrique Indicateurs en MQL4, et la méthode de croisement sur bougies clôturées dans iMA en MQL4.

L’Ichimoku est un indicateur riche mais en retard sur le prix. Testez toute règle sur un long historique et sur compte de démonstration, et protégez chaque position par un stop loss.

FAQ

L’Ichimoku fonctionne-t-il sur des unités de temps courtes ?

L’indicateur se calcule sur toutes les unités de temps, mais il a été conçu pour des graphiques journaliers. Sur M5 ou M15, le nuage change vite et les croisements sont nombreux ; beaucoup de développeurs l’utilisent alors comme filtre lu sur une unité supérieure.

Pourquoi MODE_TENKANSEN vaut 1 et non 0 ?

Les constantes de l’Ichimoku en MQL4 sont numérotées de 1 à 5 : MODE_TENKANSEN (1), MODE_KIJUNSEN (2), MODE_SENKOUSPANA (3), MODE_SENKOUSPANB (4), MODE_CHIKOUSPAN (5). Utilisez toujours les noms des constantes pour éviter toute confusion.

Comment lire le nuage situé sous la bougie actuelle ?

Les lignes Senkou Span sont dessinées en avance sur le prix. Avec l’indicateur standard, la valeur affichée sous une bougie a été calculée kijun_sen bougies plus tôt : lisez-la au shift augmenté de la période Kijun, puis vérifiez le résultat avec la fenêtre des données.

La Chikou Span est-elle utile dans un EA ?

Elle compare la clôture actuelle aux prix passés. Dans un robot, comparer directement Close[1] à Close[1 + 26] donne la même information de façon plus lisible et sans ambiguïté sur le décalage.

Faut-il changer les périodes 9, 26 et 52 sur le forex ?

Ce n’est pas obligatoire. La plupart des traders conservent ces valeurs. Si vous les modifiez, faites-le de façon cohérente et évitez de les optimiser toutes en même 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.