MQL4 · Indicateurs
iMA en MQL4 : lire une moyenne mobile et coder un croisement
La fonction iMA renvoie directement la valeur d’une moyenne mobile sur la bougie choisie. Signature, rôle du shift, piège de ma_shift, iMAOnArray et EA de croisement commenté.
En MQL4, iMA() calcule une moyenne mobile et renvoie directement sa valeur sous forme de double pour la bougie indiquée par le dernier paramètre, shift. Un appel comme iMA(NULL, 0, 20, 0, MODE_EMA, PRICE_CLOSE, 1) donne la moyenne exponentielle 20 de la dernière bougie clôturée, sur le symbole et l’unité de temps du graphique. Pas de handle, pas de tableau intermédiaire : c’est la principale différence avec MQL5. Cette page détaille la signature, la distinction souvent mal comprise entre shift et ma_shift, le calcul d’une moyenne sur vos propres données avec iMAOnArray(), et un Expert Advisor de croisement qui évite les faux signaux de la bougie en cours.
La signature de iMA
double iMA(
string symbol, // symbole, NULL = symbole courant
int timeframe, // unité de temps, 0 = celle du graphique
int ma_period, // période de la moyenne
int ma_shift, // décalage horizontal de la courbe
int ma_method, // MODE_SMA, MODE_EMA, MODE_SMMA, MODE_LWMA
int applied_price, // PRICE_CLOSE, PRICE_OPEN, ...
int shift // bougie lue : 0 = en cours, 1 = dernière clôturée
);
Les méthodes de lissage sont des constantes entières : MODE_SMA (0, moyenne simple), MODE_EMA (1, exponentielle), MODE_SMMA (2, lissée) et MODE_LWMA (3, pondérée linéairement). Le prix appliqué accepte PRICE_CLOSE (0), PRICE_OPEN (1), PRICE_HIGH (2), PRICE_LOW (3), PRICE_MEDIAN (4), PRICE_TYPICAL (5) et PRICE_WEIGHTED (6). Utilisez toujours les noms des constantes plutôt que leurs valeurs : le code reste lisible et les erreurs de position sautent aux yeux.
Le calcul et les différences entre ces quatre méthodes sont expliqués en détail sur la page iMA en MQL5 ; ils sont identiques dans les deux versions de MetaTrader. Ici, concentrons-nous sur ce qui est propre à MQL4.
shift et ma_shift : deux décalages à ne pas confondre
La signature contient deux paramètres au nom presque identique, et leur confusion est l’une des sources de bugs les plus fréquentes.
shift(le dernier paramètre) choisit la bougie que vous lisez. Il suit l’indexation des séries MQL4 : 0 est la bougie en cours, 1 la précédente, et ainsi de suite vers le passé, commeClose[1]ouTime[1]. Cette convention est détaillée dans [Tableaux de séries (Close[], Time[])](/mql4/bases/tableaux-de-series/).ma_shiftdécale la courbe elle-même vers la droite sur le graphique. Une moyenne avecma_shift = 5affiche sur la bougie actuelle la valeur calculée cinq bougies plus tôt. Certains indicateurs, comme l’Alligator, reposent sur ce décalage.
Dans un robot, laissez ma_shift à 0 sauf si vous reproduisez volontairement un indicateur décalé. Avec un ma_shift non nul, la valeur lue au shift 1 correspond à un calcul plus ancien que la bougie 1, et votre croisement sera détecté en retard sans que rien ne vous en avertisse.
La bougie 0 et les signaux qui disparaissent
Sur la bougie 0, la clôture n’est pas encore connue : PRICE_CLOSE vaut le dernier Bid reçu. La moyenne bouge donc à chaque tick, et un croisement peut se produire à 10 h 07 puis s’annuler à 10 h 12. Un EA qui achète dès le premier croisement sur la bougie 0 ouvrira des positions que le graphique historique ne montrera jamais, ce qui rend son backtest trompeur.
La solution standard consiste à comparer les bougies 1 et 2, toutes deux terminées, et à ne faire ce calcul qu’une fois au début de chaque nouvelle bougie. L’exemple ci-dessous applique cette méthode.
Exemple complet : croisement de deux moyennes
Cet Expert Advisor achète quand l’EMA rapide croise au-dessus de l’EMA lente, vend dans le cas inverse, et ne garde qu’une position à la fois. La gestion d’ordre est volontairement minimale ; la page OrderSend en MQL4 détaille la gestion des erreurs à ajouter avant tout usage réel.
#property strict
input int PeriodeRapide = 12; // période de l'EMA rapide
input int PeriodeLente = 26; // période de l'EMA lente
input double Lots = 0.10; // volume fixe
input int Magic = 41001; // identifiant des ordres de l'EA
datetime derniereBougie = 0;
int OnInit()
{
if(PeriodeRapide >= PeriodeLente) return(INIT_PARAMETERS_INCORRECT);
return(INIT_SUCCEEDED);
}
void OnTick()
{
// 1. Ne travailler qu'une fois par bougie
if(Time[0] == derniereBougie) return;
derniereBougie = Time[0];
// 2. Lire les moyennes sur les bougies clôturées 1 et 2
double rapide1 = iMA(NULL, 0, PeriodeRapide, 0, MODE_EMA, PRICE_CLOSE, 1);
double rapide2 = iMA(NULL, 0, PeriodeRapide, 0, MODE_EMA, PRICE_CLOSE, 2);
double lente1 = iMA(NULL, 0, PeriodeLente, 0, MODE_EMA, PRICE_CLOSE, 1);
double lente2 = iMA(NULL, 0, PeriodeLente, 0, MODE_EMA, PRICE_CLOSE, 2);
bool croisementHausse = (rapide2 <= lente2 && rapide1 > lente1);
bool croisementBaisse = (rapide2 >= lente2 && rapide1 < lente1);
// 3. Une seule position à la fois pour cet EA
if(CompterPositions() > 0) return;
if(croisementHausse)
{
int t = OrderSend(Symbol(), OP_BUY, Lots, Ask, 3, 0, 0, "Croisement EMA", Magic, 0, clrBlue);
if(t < 0) Print("Achat refusé, erreur ", GetLastError());
}
else if(croisementBaisse)
{
int t = OrderSend(Symbol(), OP_SELL, Lots, Bid, 3, 0, 0, "Croisement EMA", Magic, 0, clrRed);
if(t < 0) Print("Vente refusée, erreur ", GetLastError());
}
}
// Compte les ordres au marché ouverts par cet EA sur ce symbole
int CompterPositions()
{
int n = 0;
for(int i = OrdersTotal() - 1; i >= 0; i--)
{
if(!OrderSelect(i, SELECT_BY_POS, MODE_TRADES)) continue;
if(OrderSymbol() == Symbol() && OrderMagicNumber() == Magic && OrderType() <= OP_SELL) n++;
}
return(n);
}
Notez la condition de croisement : elle exige que la relation entre les deux moyennes change entre la bougie 2 et la bougie 1. Tester seulement rapide1 > lente1 déclencherait un achat à chaque nouvelle bougie tant que la tendance dure.
Calculer une moyenne sur vos propres données : iMAOnArray
iMA() ne travaille que sur les prix d’un symbole. Pour lisser une autre série, par exemple les valeurs d’un RSI ou un écart entre deux symboles, MQL4 propose iMAOnArray(). Sa signature est double iMAOnArray(double array[], int total, int ma_period, int ma_shift, int ma_method, int shift), où total est le nombre d’éléments à prendre en compte (0 pour tout le tableau). La documentation précise que le calcul se fait de gauche à droite ; pour que l’indice 0 désigne la valeur la plus récente, comme pour les séries de prix, déclarez le tableau en série avec ArraySetAsSeries().
// Moyenne simple 5 des valeurs du RSI 14 sur les 50 dernières bougies
double rsi[];
ArrayResize(rsi, 50);
ArraySetAsSeries(rsi, true); // indice 0 = bougie la plus récente
for(int i = 0; i < 50; i++)
rsi[i] = iRSI(NULL, 0, 14, PRICE_CLOSE, i);
double rsiLisse = iMAOnArray(rsi, 0, 5, 0, MODE_SMA, 1); // valeur à la bougie 1
Mesurer la pente d’une moyenne
Une moyenne ne sert pas qu’aux croisements. Sa pente indique si le marché accélère ou s’essouffle, et elle se calcule simplement en comparant deux shifts. Pour rendre la mesure indépendante de l’instrument, exprimez-la en points avec la variable prédéfinie Point :
// Pente de la SMA 50 sur les 5 dernières bougies clôturées, en points
double maRecente = iMA(NULL, 0, 50, 0, MODE_SMA, PRICE_CLOSE, 1);
double maAncienne = iMA(NULL, 0, 50, 0, MODE_SMA, PRICE_CLOSE, 6);
double pentePoints = (maRecente - maAncienne) / Point;
bool tendanceHaussiere = (pentePoints > 20); // seuil à calibrer selon le symbole
Un seuil exprimé en points n’a pas la même signification sur une paire à cinq décimales, sur l’or ou sur un indice : calibrez-le pour chaque marché, ou rapportez la pente à l’ATR pour obtenir une mesure comparable d’un symbole à l’autre.
Cas d’usage en trading et pièges
- Filtre de tendance multi-unités de temps : lire
iMA(NULL, PERIOD_H4, 200, 0, MODE_SMA, PRICE_CLOSE, 1)depuis un graphique H1 permet de n’accepter que les achats au-dessus de la moyenne longue. Attention : sur H4, la bougie 1 est la dernière bougie H4 clôturée, pas celle d’il y a une heure. - Historique non chargé : si l’unité de temps demandée n’est pas encore disponible, la fonction peut renvoyer 0. Contrôlez que la valeur est positive avant de l’utiliser et consultez GetLastError en MQL4 en cas de doute.
- Périodes trop proches : deux moyennes de périodes voisines se croisent sans cesse en marché sans direction. Le croisement seul produit beaucoup de faux signaux ; un filtre de volatilité ou de tendance est presque toujours nécessaire.
- Optimisation : la période d’une moyenne est le paramètre le plus facile à sur-ajuster. Préférez des plages larges et vérifiez la stabilité des résultats autour de l’optimum.
Pour situer cette page dans l’ensemble des fonctions disponibles, revenez à la rubrique Indicateurs en MQL4.
FAQ
Quelle est la différence entre MODE_EMA et MODE_SMMA ?
Les deux donnent plus de poids aux prix récents, mais la moyenne lissée (SMMA) réagit beaucoup plus lentement qu’une EMA de même période. Une SMMA de période N se comporte approximativement comme une EMA de période 2N − 1.
Pourquoi iMA renvoie 0 dans mon EA ?
Le plus souvent, l’historique du symbole ou de l’unité de temps demandés n’est pas disponible, ou le nom du symbole est incorrect (suffixe du courtier oublié). Testez la valeur avant de l’utiliser et réessayez au tick suivant.
Puis-je calculer la moyenne d’un autre symbole ?
Oui, en remplaçant NULL par le nom exact du symbole, par exemple « GBPUSD ». Vérifiez que le symbole est affiché dans l’Observateur de marché et que son historique est chargé.
Faut-il appeler iMA à chaque tick ?
Non. Pour un signal de croisement sur bougies clôturées, une lecture par nouvelle bougie suffit et rend le backtest plus rapide et plus fidèle.
Mon croisement apparaît sur le graphique mais l’EA n’a pas tradé, pourquoi ?
Vérifiez que les paramètres de l’EA sont exactement ceux des moyennes affichées (méthode, prix appliqué, ma_shift), que le croisement a eu lieu entre deux bougies clôturées et qu’aucune position du même magic number n’était déjà ouverte. Consultez ensuite l’onglet Journal pour repérer un éventuel refus d’ordre.
