MQL4 · Indicateurs
Indicateurs en MQL4 : appels iXXX, shift et indicateurs personnalisés
Lire les indicateurs de MetaTrader 4 dans un Expert Advisor : comprendre l’appel direct avec shift, éviter les pièges de la bougie en cours, puis créer et appeler vos propres indicateurs.
En MQL4, un indicateur technique se lit en un seul appel : iMA(), iRSI() ou iBands() renvoient directement un double, la valeur de l’indicateur sur la bougie demandée. Il n’y a ni handle à créer ni tableau à remplir comme en MQL5 : le dernier paramètre de chaque fonction, shift, désigne la bougie à lire, 0 étant la bougie en cours de formation et 1 la dernière bougie clôturée. Cette simplicité explique en grande partie la popularité historique de MetaTrader 4 auprès des développeurs de robots, mais elle cache plusieurs pièges que cette rubrique passe en revue un par un.
La rubrique est organisée en deux parties. La première couvre les indicateurs intégrés les plus utilisés dans les Expert Advisors : moyennes mobiles, oscillateurs, indicateurs de volatilité et de tendance. La seconde explique comment appeler un indicateur personnalisé avec iCustom() et comment écrire le vôtre : structure du fichier, gestion des buffers, recalcul incrémental avec IndicatorCounted() ou prev_calculated.
Le modèle d’appel MQL4 en trois points
Toutes les fonctions d’indicateurs intégrés de MQL4 partagent la même logique. Les deux premiers paramètres sont le symbole (NULL pour le symbole du graphique) et l’unité de temps (0 pour celle du graphique, ou une constante comme PERIOD_H1). Viennent ensuite les réglages propres à l’indicateur, puis, pour les indicateurs à plusieurs lignes, un paramètre mode qui choisit la ligne, et enfin shift.
// Forme générale d'un appel d'indicateur intégré en MQL4
double valeur = iRSI(NULL, // symbole courant
0, // unité de temps du graphique
14, // période
PRICE_CLOSE, // prix appliqué
1); // shift : dernière bougie clôturée
Trois conséquences pratiques reviennent dans toutes les pages de la rubrique :
- la bougie 0 n’est pas terminée : sa valeur change à chaque tick, si bien qu’un signal lu sur
shift = 0peut apparaître puis disparaître avant la clôture. Les exemples de la rubrique lisent la bougie 1 et ne calculent qu’une fois par nouvelle bougie ; - les lignes se choisissent par une constante
MODE_dont la valeur numérique compte :MODE_MAINvaut 0 etMODE_SIGNALvaut 1 pour le MACD ou le stochastique, alors que l’Ichimoku numérote ses lignes à partir de 1 ; - une autre unité de temps exige un historique chargé : appeler
iMA(NULL, PERIOD_D1, ...)depuis un graphique M15 fonctionne, mais la première lecture peut échouer tant que le terminal n’a pas les données. Testez toujours le résultat et consultezGetLastError().
L’indexation « à l’envers » des séries de prix, où l’indice 0 est la bougie la plus récente, est détaillée dans [Tableaux de séries (Close[], Time[])](/mql4/bases/tableaux-de-series/). Le shift des indicateurs suit exactement la même convention.
Ordre de lecture conseillé
- Commencez par iMA en MQL4 : c’est la page qui détaille le plus le paramètre
shift, le décalagema_shiftet la détection d’un croisement sur bougies clôturées. - Enchaînez avec un oscillateur simple, iRSI en MQL4, puis avec un indicateur à deux lignes, iMACD en MQL4, pour maîtriser le paramètre
mode. - Lisez ensuite les pages qui correspondent à votre stratégie : volatilité, tendance ou retournement.
- Terminez par la partie « indicateurs personnalisés » si vous voulez écrire vos propres outils ou réutiliser un indicateur
.ex4existant.
Les indicateurs intégrés
Moyennes et oscillateurs
- iMA en MQL4 : moyennes mobiles simple, exponentielle, lissée et pondérée, croisement de deux moyennes et calcul sur un tableau avec
iMAOnArray(). - iRSI en MQL4 : lire le RSI, franchissements de niveaux et filtre de tendance sur une unité de temps supérieure.
- iMACD en MQL4 : ligne principale, ligne de signal et particularités du MACD de MetaTrader 4.
- iStochastic en MQL4 : %K, %D, ralentissement et choix du prix Low/High ou Close/Close.
- iCCI en MQL4 : le Commodity Channel Index et ses seuils de ±100.
Volatilité
- iBands en MQL4 : bandes de Bollinger, lignes
MODE_MAIN,MODE_UPPER,MODE_LOWERet mesure de la largeur des bandes. - iATR en MQL4 : l’Average True Range pour dimensionner un stop loss ou filtrer les marchés trop calmes.
Tendance et retournement
- iADX en MQL4 : force de la tendance et lignes directionnelles +DI et −DI.
- iIchimoku en MQL4 : les cinq lignes de l’Ichimoku Kinko Hyo et le piège des lignes décalées dans le temps.
- iSAR en MQL4 : le Parabolic SAR comme signal de retournement ou comme stop suiveur.
- iFractals en MQL4 : repérer les fractales hautes et basses et comprendre pourquoi elles ne sont confirmées qu’après deux bougies.
Les indicateurs personnalisés
- iCustom en MQL4 : appeler un indicateur compilé depuis un EA, transmettre ses paramètres dans le bon ordre et lire le bon buffer.
- Créer un indicateur en MQL4 : la structure complète d’un indicateur, des directives
#propertyàOnCalculate(). - IndicatorCounted et prev_calculated : ne recalculer que les bougies nouvelles, avec l’ancienne et la nouvelle syntaxe.
- Buffers d’indicateur en MQL4 : déclarer, styliser et masquer des buffers, flèches et valeurs vides.
MQL4 ou MQL5 : ce qui change pour les indicateurs
Si vous maintenez des robots sur les deux plateformes, gardez en tête la différence de modèle. En MQL5, iMA() renvoie un handle créé une fois dans OnInit(), et les valeurs se copient ensuite avec CopyBuffer(). En MQL4, l’appel renvoie immédiatement la valeur, ce qui rend le code plus court mais pousse à multiplier les appels dans OnTick(). Les pages de cette rubrique se concentrent sur la syntaxe MQL4 ; chacune renvoie vers sa page équivalente de la rubrique Indicateurs en MQL5. Pour convertir un robot existant, la page Des fonctions iXXX aux handles détaille la méthode.
Bonnes pratiques communes à toute la rubrique
- Calculez vos signaux une fois par bougie, en comparant
Time[0]à l’heure mémorisée de la dernière bougie traitée. Cela évite les signaux fantômes et allège le testeur. - Stockez les valeurs lues dans des variables nommées (
maRapide1,maRapide2) plutôt que de répéter les appels dans les conditions : le code devient lisible et vous évitez les incohérences de paramètres. - Compilez avec
#property strictpour que le compilateur signale les conversions de types douteuses. - Vérifiez vos lectures en comparant les valeurs imprimées par
Print()avec la fenêtre des données du terminal (Ctrl+D) sur la même bougie. - Un indicateur ne décide pas à votre place : il reste à définir la gestion du risque, la taille de position et les règles de sortie, abordées dans Premier EA en MQL4.
FAQ
Pourquoi mon indicateur MQL4 renvoie une valeur différente de celle du graphique ?
Vérifiez d’abord le shift : la fenêtre des données affiche la bougie survolée, alors que shift 0 désigne la bougie en cours. Comparez ensuite chaque paramètre (période, méthode, prix appliqué) avec ceux de l’indicateur posé sur le graphique : un seul écart suffit à changer la valeur.
Faut-il lire la bougie 0 ou la bougie 1 ?
Pour un signal d’entrée, la bougie 1 est la plus sûre car elle est terminée et ne changera plus. La bougie 0 sert surtout pour des calculs qui doivent suivre le prix en temps réel, comme un stop suiveur fondé sur l’ATR ou le SAR.
Les fonctions iXXX sont-elles lentes en MQL4 ?
Un appel isolé est rapide, mais des dizaines d’appels à chaque tick sur plusieurs unités de temps finissent par peser, surtout en optimisation. Limitez les calculs à une fois par bougie et ne lisez que les valeurs dont vous avez besoin.
Peut-on lire un indicateur sur un autre symbole ?
Oui, en passant son nom au premier paramètre, par exemple « EURUSD ». Le symbole doit être disponible chez votre courtier (attention aux suffixes) et son historique chargé. Dans le testeur de MetaTrader 4, seules les données du symbole testé sont modélisées tick par tick.
