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.
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 racineMQL5\Indicators. S’il ne trouve rien, la fonction renvoieINVALID_HANDLEet 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 racineMQL5. - Pour un sous-dossier, la barre oblique inverse s’écrit doublée dans la chaîne :
"MesIndicateurs\\RangeMoyen"désigneMQL5\Indicators\MesIndicateurs\RangeMoyen.ex5. - L’extension
.ex5n’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 :
- 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.
- Si l’indicateur utilise la forme courte de
OnCalculate()(celle qui reçoit un tableauprice[]), 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ètreint, ou14à 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
inputau début de l’indicateur, tous les appelsiCustom()existants se décalent silencieusement. Ajoutez toujours les nouveaux paramètres en fin de liste. - Les valeurs vides. Beaucoup d’indicateurs écrivent
EMPTY_VALUEdans 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().
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.
- 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
- Créer un indicateur personnalisé
- Buffers et styles de tracé
- OnCalculate et prev_calculated
- Indicateur multi-timeframe
- Objets graphiques (ObjectCreate)
