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

MQL5 · Indicateurs

iCustom en MQL5 : appeler un indicateur personnalisé depuis un EA

iCustom() charge un indicateur .ex5 et renvoie un handle. Chemin, ordre des paramètres, numérotation des buffers, tester_indicator et erreur 4802, avec un EA complet.

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

iCustom() permet à un Expert Advisor, un script ou un autre indicateur d’utiliser un indicateur personnalisé compilé (fichier .ex5) exactement comme un indicateur intégré : on obtient un handle, puis on lit ses buffers avec CopyBuffer(). Sa signature est int iCustom(string symbol, ENUM_TIMEFRAMES period, string name, ...), où les points de suspension représentent les paramètres d’entrée de l’indicateur. La fonction est simple ; ce qui échoue presque toujours, c’est le contrat entre l’appelant et l’indicateur : le chemin du fichier, l’ordre et le type des paramètres, et la numérotation des buffers. Cette page traite ces trois points un par un.

La signature

int iCustom(
   string           symbol,   // symbole, NULL = courant
   ENUM_TIMEFRAMES  period,   // unité de temps, 0 = courante
   string           name,     // chemin de l'indicateur, sans extension
   ...                        // paramètres d'entrée de l'indicateur, dans l'ordre
   );

La fonction renvoie un handle ou INVALID_HANDLE. Comme pour tout handle, libérez-le avec IndicatorRelease() lorsque vous n’en avez plus besoin. Si le cycle handle / CopyBuffer ne vous est pas familier, lisez d’abord Handles d’indicateurs et CopyBuffer.

Premier point du contrat : le chemin

La documentation décrit précisément la recherche du fichier :

  • Sans barre oblique inverse au début, par exemple "RangeMoyen", le terminal cherche d’abord dans le dossier où se trouve le fichier EX5 du programme appelant, puis à la racine MQL5\Indicators. S’il ne trouve rien, la fonction renvoie INVALID_HANDLE et l’erreur 4802 (ERR_INDICATOR_CANNOT_CREATE) est positionnée.
  • Avec une barre oblique inverse au début, par exemple "\\Indicators\\RangeMoyen" dans le code source, le chemin est relatif au dossier racine MQL5.
  • Pour un sous-dossier, la barre oblique inverse s’écrit doublée dans la chaîne : "MesIndicateurs\\RangeMoyen" désigne MQL5\Indicators\MesIndicateurs\RangeMoyen.ex5.
  • L’extension .ex5 n’est pas nécessaire : les exemples de la documentation donnent le nom sans extension.

L’erreur la plus courante est d’écrire une seule barre oblique inverse, "MesIndicateurs\RangeMoyen" : dans une chaîne MQL5, comme en C, la barre oblique inverse introduit une séquence d’échappement. Elle doit donc être doublée pour désigner un vrai séparateur de dossier. La seconde erreur classique est d’oublier de compiler l’indicateur : seul le .ex5 est chargé, pas le .mq5.

Deuxième point : les paramètres, dans l’ordre et avec les bons types

Après le nom, vous passez les paramètres input de l’indicateur, séparés par des virgules. La documentation est stricte : leur type et leur ordre doivent correspondre aux déclarations de l’indicateur. Si vous les omettez, les valeurs par défaut sont utilisées. Le compilateur ne peut rien vérifier, puisqu’il ne connaît pas l’indicateur appelé : un paramètre décalé passe la compilation et produit simplement des valeurs fausses.

Deux règles pratiques en découlent :

  1. Vous pouvez omettre des paramètres en fin de liste, mais pas au milieu : pour modifier le troisième paramètre, il faut passer les deux premiers.
  2. Si l’indicateur utilise la forme courte de OnCalculate() (celle qui reçoit un tableau price[]), le prix appliqué ou le handle d’un autre indicateur se place en dernier, après tous les paramètres d’entrée.

Pour un indicateur que vous ne maîtrisez pas, ouvrez son code source ou sa fenêtre de propriétés et recopiez la liste des paramètres dans l’ordre exact.

Troisième point : quels buffers lire ?

CopyBuffer(handle, n, ...) lit le buffer d’index n tel qu’il a été lié dans l’indicateur par SetIndexBuffer(n, ...). La numérotation est celle des buffers, pas des tracés : dans un indicateur qui dessine une ligne colorée, le buffer 0 contient les valeurs et le buffer 1 les index de couleur. Si vous demandez un index qui n’existe pas, l’erreur 4812 (ERR_INDICATOR_WRONG_INDEX) vous le signale. Avant d’écrire le code appelant, faites la liste des SetIndexBuffer() de l’indicateur ; la page Buffers et styles de tracé explique comment cette numérotation est construite.

Exemple complet : un EA qui utilise un indicateur personnalisé

L’indicateur appelé est RangeMoyen, construit pas à pas sur la page Créer un indicateur personnalisé. Il est enregistré dans MQL5\Indicators\MesIndicateurs\ et déclare ceci :

//--- extrait de RangeMoyen.mq5 (l'indicateur appelé)
input int InpPeriod = 14;   // période de la moyenne de l'amplitude
//--- buffer 0 : amplitude moyenne en points (tracée)
//--- buffer 1 : amplitude brute en points (calculs intermédiaires)

L’Expert Advisor suivant l’appelle avec une période choisie par l’utilisateur et l’utilise comme filtre de volatilité.

//+------------------------------------------------------------------+
//| RangeFilterEA.mq5 - appel d'un indicateur personnalisé           |
//+------------------------------------------------------------------+
input int    InpRangePeriod = 14;    // transmis à RangeMoyen (1er input)
input double InpMinRange    = 80.0;  // amplitude moyenne minimale, en points

int hRange = INVALID_HANDLE;

int OnInit()
  {
   //--- nom avec double barre oblique inverse, paramètres dans l'ordre déclaré
   hRange = iCustom(_Symbol, PERIOD_CURRENT, "MesIndicateurs\\RangeMoyen", InpRangePeriod);
   if(hRange == INVALID_HANDLE)
     {
      int err = GetLastError();
      PrintFormat("iCustom : échec, erreur %d%s", err,
                  err == 4802 ? " (fichier .ex5 introuvable ou non compilé ?)" : "");
      return(INIT_FAILED);
     }
   return(INIT_SUCCEEDED);
  }

void OnDeinit(const int reason)
  {
   if(hRange != INVALID_HANDLE)
      IndicatorRelease(hRange);
  }

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

   double range[];
   ArraySetAsSeries(range, true);
   if(CopyBuffer(hRange, 0, 1, 1, range) != 1)   // buffer 0, bougie close 1
     {
      PrintFormat("CopyBuffer : données indisponibles, erreur %d", GetLastError());
      return;
     }
   lastBar = bar;

   bool tradable = range[0] >= InpMinRange;
   PrintFormat("%s : amplitude moyenne %.1f pts -> %s", _Symbol, range[0],
               tradable ? "volatilité suffisante" : "marché trop calme");
  }

Le message d’erreur personnalisé pour le code 4802 fait gagner un temps précieux : dans neuf cas sur dix, le problème vient d’un chemin erroné ou d’un indicateur non compilé.

La directive tester_indicator

Pour qu’un EA fonctionne dans le testeur de stratégie, en particulier sur des agents distants, l’indicateur appelé doit être transmis avec lui. La documentation précise que les indicateurs sont détectés automatiquement lorsque iCustom() reçoit un nom constant. Si le nom est construit dynamiquement (concaténation, paramètre input) ou si l’indicateur est créé avec IndicatorCreate(), il faut déclarer #property tester_indicator "nom_indicateur.ex5". Dans l’exemple ci-dessus, le nom est une chaîne constante : la directive n’est donc pas nécessaire. Elle le deviendrait si vous décidiez de lire le nom de l’indicateur dans un paramètre input. Les agents de test sont présentés sur la page Agents locaux et MQL5 Cloud Network.

Vérifier l’appel avant de l’exploiter

Comme le compilateur ne contrôle pas le contrat, contrôlez-le vous-même au premier lancement. Attachez l’indicateur au graphique avec les mêmes paramètres que dans votre appel, lancez l’EA, et comparez la valeur imprimée dans le journal avec celle de la fenêtre de données pour la même bougie. Si elles diffèrent, l’un des trois points du contrat est en cause : paramètre décalé, mauvais buffer ou décalage d’index. Une autre vérification utile consiste à appeler BarsCalculated(hRange) juste après la création : tant que la valeur est négative ou nulle, l’indicateur n’a pas encore calculé, et toute lecture échouera. Ce contrôle évite de confondre un problème de données pas encore prêtes avec un problème de paramètres.

Pièges fréquents

  • Les types de paramètres. Passer 14.0 à un paramètre int, ou 14 à un paramètre de type énumération, peut donner un résultat inattendu. Utilisez le type exact déclaré dans l’indicateur.
  • Les modifications de l’indicateur. Si vous ajoutez un paramètre input au début de l’indicateur, tous les appels iCustom() existants se décalent silencieusement. Ajoutez toujours les nouveaux paramètres en fin de liste.
  • Les valeurs vides. Beaucoup d’indicateurs écrivent EMPTY_VALUE dans les bougies où ils ne tracent rien (flèches, sections). Testez cette valeur avant de l’utiliser dans un calcul.
  • Les indicateurs qui se recalculent. Certains indicateurs modifient leurs valeurs passées (repaint). L’EA lira alors en temps réel des valeurs différentes de celles que montre l’historique, et le backtest sera trompeur.
  • Les noms dynamiques. Construire le nom à partir d’un paramètre est possible, mais n’oubliez pas tester_indicator.

La rubrique Indicateurs en MQL5 présente aussi les indicateurs intégrés, qui ne nécessitent pas iCustom().

Un indicateur personnalisé tiers peut contenir des erreurs ou recalculer ses valeurs passées. Vérifiez son comportement en test visuel et en démo avant de confier des ordres réels à un robot qui en dépend.

FAQ

Pourquoi iCustom renvoie-t-il INVALID_HANDLE avec l’erreur 4802 ?

Le plus souvent, le terminal ne trouve pas le fichier .ex5 : chemin erroné, barre oblique inverse non doublée, ou indicateur jamais compilé. Vérifiez la présence du fichier dans MQL5\Indicators ou le sous-dossier indiqué.

Faut-il écrire l’extension .ex5 dans le nom ?

Non. Les exemples de la documentation donnent le nom sans extension. L’extension apparaît en revanche dans la directive #property tester_indicator.

Peut-on omettre certains paramètres de l’indicateur ?

Oui, ceux de fin de liste : les valeurs par défaut sont alors utilisées. Pour changer un paramètre, il faut passer tous ceux qui le précèdent, dans l’ordre et avec le bon type.

Comment savoir quel numéro de buffer lire ?

Regardez les appels SetIndexBuffer() dans le code de l’indicateur : l’index passé en premier argument est celui à utiliser dans CopyBuffer(). Les buffers de couleur et de calcul intermédiaire comptent dans la numérotation.

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.