MQL5 · Indicateurs
Indicateurs en MQL5 : handles, CopyBuffer et indicateurs intégrés
Utiliser les indicateurs de MetaTrader 5 dans un robot : créer un handle, lire les buffers avec CopyBuffer, puis exploiter chaque indicateur intégré ou personnalisé avec méthode.
En MQL5, un indicateur technique ne se lit pas comme en MQL4 : vous créez d’abord un handle (un identifiant vers une copie de l’indicateur calculée par le terminal), puis vous copiez ses valeurs dans un tableau avec CopyBuffer(). Cette rubrique rassemble tout ce qu’il faut savoir pour exploiter les indicateurs intégrés de MetaTrader 5 depuis un Expert Advisor ou un script, puis pour créer vos propres indicateurs. Chaque page traite d’un seul sujet : une fonction iXXX, un mécanisme (buffers, OnCalculate, multi-timeframe) ou une technique (appel d’un indicateur personnalisé, objets graphiques).
Les pages d’indicateurs suivent toutes la même exigence : expliquer le calcul et la lecture de l’indicateur, donner la signature exacte de la fonction MQL5 et ses numéros de buffers tels qu’ils figurent dans la documentation officielle, fournir un exemple de code complet qui lit les valeurs avec CopyBuffer(), et discuter honnêtement des usages en trading algorithmique et de leurs limites. Chaque page adopte un angle différent (filtre de régime, dimensionnement du risque, trailing stop, calibrage d’un paramètre, détection d’un motif…) pour que vous appreniez une technique nouvelle à chaque lecture.
Comment MQL5 gère les indicateurs
Toutes les fonctions comme iMA, iRSI ou iIchimoku créent une copie de l’indicateur dans le cache du terminal et renvoient un entier, le handle. Si une copie avec exactement les mêmes paramètres existe déjà, le terminal la réutilise au lieu d’en calculer une nouvelle. Le calcul prend un peu de temps : la documentation recommande donc de créer les handles dans OnInit() et de lire les données plus tard, dans OnTick() ou OnTimer(). Quand un handle ne sert plus, IndicatorRelease() libère la mémoire.
Ce modèle a trois conséquences pratiques que vous retrouverez dans toute la rubrique :
- un handle invalide vaut
INVALID_HANDLE: il faut toujours le tester avant de continuer ; CopyBuffer()peut renvoyer -1 ou moins de valeurs que demandé tant que les données ne sont pas prêtes : il faut tester le nombre de valeurs copiées ;- les buffers sont numérotés à partir de 0, et un indicateur à plusieurs lignes (MACD, Bollinger, Ichimoku…) impose de connaître le bon numéro de buffer.
Si vous venez de MQL4, la page Des fonctions iXXX aux handles détaille la conversion de vos anciens appels.
Ordre de lecture conseillé
- Commencez impérativement par Handles d’indicateurs et CopyBuffer : c’est la fondation de toutes les autres pages.
- Lisez ensuite iMA, iRSI et iATR : ce sont les trois indicateurs les plus utilisés dans les robots, et leurs pages couvrent respectivement le signal de croisement, la lecture d’un oscillateur borné et le dimensionnement du risque.
- Passez aux indicateurs à plusieurs buffers : iMACD, iBands, iADX puis iIchimoku, qui introduit les lignes décalées dans le temps.
- Piochez ensuite selon votre stratégie parmi les autres oscillateurs, indicateurs de Bill Williams et indicateurs de volume.
- Terminez par la partie « indicateurs personnalisés » : iCustom, Créer un indicateur personnalisé, Buffers et styles de tracé et OnCalculate et prev_calculated.
Pour savoir quand lire un indicateur dans un EA (en général à l’ouverture d’une nouvelle bougie, sur la bougie clôturée), consultez aussi Détecter une nouvelle bougie dans la rubrique Expert Advisors.
Le socle : handles et lecture des buffers
- Handles d’indicateurs et CopyBuffer : création des handles, cache du terminal, les trois variantes de
CopyBuffer(),BarsCalculated(),IndicatorRelease()et l’indexation en série.
Moyennes mobiles et indicateurs de tendance
- iMA : moyennes mobiles : les quatre méthodes de lissage, le décalage
ma_shiftet un croisement de moyennes détecté sur bougie clôturée. - iADX : force de tendance et lignes +DI/-DI, utilisées comme filtre de régime tendance/range.
- iIchimoku : cinq buffers, nuage projeté dans le futur et lecture correcte des lignes décalées.
- iSAR : Parabolic SAR : un trailing stop prêt à l’emploi, codé avec la classe CTrade.
- iAlligator : les trois moyennes de Bill Williams et la mesure de l’« éveil » du marché.
- iAMA : moyenne mobile adaptative : une moyenne qui accélère en tendance et ralentit dans le bruit.
- iDEMA et iTEMA : moyennes à retard réduit et comparaison avec l’EMA.
- iFrAMA : moyenne adaptative fondée sur la dimension fractale.
Oscillateurs de momentum
- iRSI : Relative Strength Index : lecture des zones, temps passé en surachat et filtre multi-unité de temps.
- iMACD : ligne principale, ligne de signal et reconstitution de l’histogramme.
- iStochastic : réglages %K, %D, ralentissement et choix du prix de calcul.
- iCCI : un oscillateur non borné, lu en mode tendance autour de ±100.
- iMomentum : un ratio centré sur 100 et un classement de symboles par force relative.
- iWPR : Williams %R : échelle de -100 à 0 et règle de sortie de zone.
- iDeMarker : épuisement des plus hauts et des plus bas.
- iRVI : vigueur de la clôture par rapport à l’ouverture.
- iOsMA : l’histogramme MACD sous forme d’indicateur à un seul buffer.
- iBearsPower et iBullsPower : la pression acheteuse et vendeuse autour d’une EMA.
- iForce : variation de prix pondérée par le volume.
Volatilité et canaux
- iBands : bandes de Bollinger : %B, largeur de bande et détection de compression.
- iATR : Average True Range : stop et taille de position exprimés en ATR.
- iEnvelopes : enveloppes en pourcentage et calibrage de l’écart.
- iStdDev : écart-type : mesure brute de dispersion pour vos filtres de volatilité.
Indicateurs de Bill Williams
- iAO : Awesome Oscillator : reconstituer les couleurs et détecter la « soucoupe ».
- iAC : Accelerator Oscillator : compter les barres de même couleur selon la position par rapport à zéro.
- iFractals :
EMPTY_VALUE, délai de confirmation et placement de stops sous les fractales.
Indicateurs de volume
- iOBV : On Balance Volume : volume cumulé, pente et divergences.
- iMFI : Money Flow Index : un RSI pondéré par le volume.
- iVolumes : volume tick ou volume réel, et ce que chacun mesure vraiment.
Indicateurs personnalisés et affichage
- iCustom : appeler un indicateur personnalisé : passer les paramètres et lire les buffers d’un indicateur tiers.
- Créer un indicateur personnalisé : la structure minimale d’un fichier d’indicateur.
- Buffers et styles de tracé :
SetIndexBuffer, plots et couleurs. - OnCalculate et prev_calculated : ne recalculer que les nouvelles barres.
- Indicateur multi-timeframe : afficher des données d’une unité de temps supérieure.
- Objets graphiques (ObjectCreate) : lignes, flèches et étiquettes sur le graphique.
Ce que les indicateurs peuvent et ne peuvent pas faire
Un indicateur n’est qu’une transformation des prix ou des volumes passés. Il ne contient aucune information que la série de prix ne contient pas déjà ; il la résume d’une façon plus lisible pour une règle de décision. Dans un robot, sa valeur vient donc de la manière dont vous l’utilisez : comme déclencheur d’entrée, comme filtre de contexte, comme mesure de volatilité pour dimensionner un stop, ou comme critère de sortie. Les pages de la rubrique insistent sur ces rôles plutôt que sur des « signaux magiques ».
Deux pièges reviennent constamment. Le premier est la lecture de la bougie en cours : sa valeur change à chaque tick, et un signal calculé dessus peut apparaître puis disparaître. La plupart des exemples lisent donc la bougie d’indice 1, déjà clôturée. Le second est la sur-optimisation des périodes : tester des dizaines de combinaisons de réglages finit toujours par produire une courbe flatteuse. Avant de faire confiance à un réglage, lisez la page Sur-optimisation.
FAQ
Pourquoi mon CopyBuffer renvoie -1 juste après la création du handle ?
Le terminal n’a pas encore calculé l’indicateur. Créez le handle dans OnInit() et lisez les valeurs dans OnTick() ; si la copie échoue, sortez simplement de la fonction et réessayez au tick suivant. La page Handles d’indicateurs et CopyBuffer détaille BarsCalculated() pour vérifier l’état du calcul.
Faut-il créer un nouveau handle à chaque tick ?
Non. Le terminal réutilise une copie existante quand les paramètres sont identiques, mais créer un handle à chaque tick reste inutile et source d’erreurs. Créez-le une fois dans OnInit(), stockez-le dans une variable globale et libérez-le dans OnDeinit() avec IndicatorRelease().
Comment savoir quel numéro de buffer utiliser ?
La documentation de chaque fonction indique les numéros de buffers. Par exemple, iMACD expose 0 pour la ligne principale et 1 pour la ligne de signal, iBands expose 0 pour la ligne médiane, 1 pour la bande haute et 2 pour la bande basse. Chaque page de cette rubrique les rappelle.
Peut-on lire un indicateur d’une autre unité de temps ou d’un autre symbole ?
Oui : les deux premiers paramètres de chaque fonction iXXX sont le symbole et l’unité de temps. Passez par exemple PERIOD_H4 depuis un graphique M15. Vérifiez simplement que l’historique du symbole et de l’unité de temps demandés est disponible.
- Handles d’indicateurs et CopyBuffer
- iMA : moyennes mobiles
- iRSI : Relative Strength Index
- iMACD
- iBands : bandes de Bollinger
- iATR : Average True Range
- iStochastic
- iADX
- iCCI
- iMomentum
- iIchimoku
- iSAR : Parabolic SAR
- iEnvelopes
- iWPR : Williams %R
- iAO : Awesome Oscillator
- iAC : Accelerator Oscillator
- iAlligator
- iFractals
- iOBV : On Balance Volume
- iMFI : Money Flow Index
- iVolumes
- iStdDev : écart-type
- iDeMarker
- iBearsPower et iBullsPower
- iForce
- iOsMA
- iRVI
- iAMA : moyenne mobile adaptative
- iDEMA et iTEMA
- iFrAMA
- iCustom : appeler un indicateur personnalisé
- Créer un indicateur personnalisé
- Buffers et styles de tracé
- OnCalculate et prev_calculated
- Indicateur multi-timeframe
- Objets graphiques (ObjectCreate)
