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

MQL4 · Codes d’erreur

Erreur 4051 en MQL4 (ERR_INVALID_FUNCTION_PARAMVALUE) : valider les paramètres de vos fonctions

L’erreur 4051 indique qu’une fonction MQL4 a reçu une valeur de paramètre invalide. Générique par nature, elle se diagnostique par le journal et se prévient en validant les entrées dès OnInit.

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

L’erreur 4051, constante ERR_INVALID_FUNCTION_PARAMVALUE, signale qu’une fonction a reçu une valeur de paramètre invalide. C’est une erreur d’exécution, détectée par le terminal et non par le serveur de trading : l’appel n’a pas été exécuté parce qu’un de ses arguments sort du domaine accepté. Contrairement à la plupart des codes de trading, elle n’est pas propre à une fonction : n’importe quelle fonction native peut la produire.

Ce caractère générique fait sa difficulté. Le code seul ne dit pas quel paramètre pose problème, ni dans quelle fonction. L’angle de cette page est donc double : diagnostiquer en exploitant le journal et le contexte, puis prévenir en validant les valeurs avant les appels, et en premier lieu les paramètres saisis par l’utilisateur.

Attention à ne pas la confondre avec sa voisine 4050 (ERR_INVALID_FUNCTION_PARAMSCNT), qui signale un nombre de paramètres incorrect, et avec 4062 à 4065, qui signalent un type de paramètre inattendu (chaîne, entier, double ou tableau attendu). La 4051 concerne la valeur.

D’où vient l’erreur 4051 ?

On la rencontre dans des situations variées, qui ont toutes en commun une valeur que la fonction ne peut pas traiter :

  • un volume nul ou négatif transmis à une fonction de trading, souvent issu d’un calcul de lot qui a mal tourné ;
  • un ticket ou un identifiant manifestement invalide (0, -1) passé à une fonction qui attend un ordre existant ;
  • une période ou un paramètre d’indicateur hors domaine, comme une moyenne mobile de période 0 ;
  • une valeur d’énumération inattendue, par exemple un type d’ordre calculé qui ne correspond à aucune constante OP_... ;
  • un décalage ou un indice négatif là où la fonction attend une valeur positive.

Dans tous les cas, la cause première est presque toujours une variable non initialisée, un calcul sans garde-fou ou un paramètre utilisateur aberrant. L’erreur 4051 est le symptôme, pas la maladie.

Diagnostiquer : le journal avant le code

Lorsque le terminal rejette un paramètre, il écrit généralement dans l’onglet Experts un message en anglais qui nomme la fonction et le paramètre concerné, par exemple un message du type « invalid lots amount for OrderSend function ». Ce message est bien plus informatif que le code 4051 seul : consultez-le en priorité, dans l’onglet Experts ou dans les fichiers du dossier MQL4\Logs.

Ensuite, journalisez toutes les valeurs passées à la fonction qui échoue. Dans 90 % des cas, une valeur saute aux yeux : un volume à 0, une période à 0, un ticket à -1. La fonction de journalisation proposée dans GetLastError en MQL4 peut être étendue pour inclure ces arguments.

Reproduire l’erreur pour la comprendre

Le moyen le plus rapide de se familiariser avec la 4051 est de la provoquer volontairement dans un script de test, sur un compte de démonstration : appelez une fonction avec une valeur manifestement hors domaine, lisez le code avec GetLastError() et observez le message écrit dans l’onglet Experts. Vous verrez ainsi la forme exacte des messages de votre version du terminal, ce qui facilitera le diagnostic le jour où l’erreur apparaîtra dans un EA réel. Cette démarche vaut pour toutes les erreurs d’exécution : connaître le message associé à un code fait gagner un temps considérable.

Une fois le message identifié, remontez la chaîne de calcul de la valeur fautive. Une valeur aberrante transmise à une fonction provient presque toujours d’une étape antérieure : une lecture de propriété qui a échoué et renvoyé 0, une division mal protégée, un paramètre utilisateur non contrôlé. Corriger cette étape en amont est plus robuste que d’ajouter un test juste avant l’appel.

Prévenir : valider les paramètres dès OnInit

La source la plus fréquente de valeurs aberrantes est l’utilisateur lui-même : une période saisie à 0, un risque de 50 %, une distance de stop négative. MQL4 permet de refuser le démarrage de l’EA en renvoyant INIT_PARAMETERS_INCORRECT depuis OnInit(). L’utilisateur voit alors immédiatement que son réglage est refusé, au lieu de découvrir des erreurs 4051 en cours de séance.

//+------------------------------------------------------------------+
//| Validation des paramètres utilisateur pour éviter l'erreur 4051  |
//+------------------------------------------------------------------+
#property strict

input int    InpMaPeriod = 50;     // période de la moyenne mobile
input double InpRiskPct  = 1.0;    // risque par trade (%)
input int    InpStopPts  = 300;    // stop loss (points)
input double InpFixedLot = 0.0;    // lot fixe (0 = calcul selon le risque)

int OnInit()
  {
   string problem = "";
   if(InpMaPeriod < 1)                       problem = "période de moyenne < 1";
   else if(InpRiskPct <= 0 || InpRiskPct > 5) problem = "risque hors de ]0 ; 5] %";
   else if(InpStopPts <= 0)                  problem = "stop loss nul ou négatif";
   else if(InpFixedLot < 0)                  problem = "lot fixe négatif";
   else if(InpFixedLot > 0 && InpFixedLot < MarketInfo(Symbol(), MODE_MINLOT))
      problem = "lot fixe inférieur au minimum du symbole";

   if(problem != "")
     {
      Alert("Paramètre refusé : ", problem);
      return INIT_PARAMETERS_INCORRECT;     // l'EA ne démarre pas
     }
   return INIT_SUCCEEDED;
  }

//--- garde-fou au moment de l'appel : jamais de volume nul transmis
bool SafeBuy(const double lots, const int magic)
  {
   if(lots <= 0)
     {
      Print("SafeBuy : volume nul ou négatif, envoi annulé");
      return false;
     }
   ResetLastError();
   int ticket = OrderSend(Symbol(), OP_BUY, lots, NormalizeDouble(Ask, Digits),
                          3, 0, 0, "", magic, 0, clrNONE);
   if(ticket < 0)
     {
      int err = GetLastError();
      PrintFormat("OrderSend lots=%.8f : erreur %d", lots, err);
      return false;
     }
   return true;
  }

void OnTick() { }

Les bornes choisies ici (risque entre 0 et 5 %, par exemple) sont des choix de conception. L’important est de rendre explicites les hypothèses de votre code : si une fonction suppose une période positive, vérifiez-le une fois au démarrage plutôt que de laisser le terminal le découvrir à chaque tick. Les mots-clés input et extern, et leurs différences, sont présentés dans extern et input.

Cas d’usage en trading

Les calculs de lot

Le volume est le paramètre le plus exposé, parce qu’il résulte souvent d’une chaîne de calculs : solde, risque, distance du stop, valeur du tick. Si l’un de ces termes vaut 0 (valeur du tick non encore disponible au démarrage, stop nul), le volume devient nul, infini ou négatif. Ajoutez un garde-fou à chaque division et arrondissez le résultat aux contraintes du symbole, comme expliqué dans Erreur 131 : volume invalide.

Les variables non initialisées

Une variable locale non initialisée peut contenir n’importe quelle valeur. Le mode #property strict du compilateur aide à repérer ces situations en produisant davantage d’avertissements ; ne les ignorez pas. La page #property strict explique ce que change ce mode.

Les indicateurs personnalisés

Avec iCustom, les paramètres sont transmis dans l’ordre de déclaration des input de l’indicateur. Un paramètre décalé, ou d’un mauvais type, peut se traduire par une valeur invalide côté indicateur. Vérifiez scrupuleusement l’ordre et le nombre des paramètres.

Les valeurs lues trop tôt

Certaines propriétés ne sont pas immédiatement disponibles au démarrage du terminal ou juste après le changement de symbole d’un graphique : une valeur de tick ou une marge requise peut alors valoir 0 pendant quelques instants. Si votre calcul s’en sert sans contrôle, il produit une valeur aberrante transmise ensuite à une fonction. Vérifiez que ces propriétés sont strictement positives avant de les utiliser, et reportez le calcul au tick suivant dans le cas contraire.

Une erreur à corriger, jamais à réessayer

Comme toutes les erreurs d’exécution de la famille 4000, la 4051 ne disparaîtra pas en réessayant : le même appel avec les mêmes valeurs produira le même refus. La vue d’ensemble des codes et de leur traitement figure dans Codes d’erreur MQL4.

Une valeur aberrante dans un calcul de volume ou de stop peut avoir des conséquences importantes si elle n’est pas détectée. Validez systématiquement vos paramètres et vos calculs, et testez l’EA en démonstration avec des réglages extrêmes. Le trading comporte un risque de perte en capital.

Questions fréquentes

Que signifie l’erreur 4051 ?

Qu’une fonction MQL4 a reçu une valeur de paramètre invalide, hors de son domaine. C’est une erreur détectée par le terminal, avant toute communication avec le serveur.

Comment savoir quel paramètre est en cause ?

Consultez l’onglet Experts : le terminal y écrit généralement un message qui nomme la fonction et le paramètre refusé. Journalisez ensuite toutes les valeurs passées à la fonction pour identifier celle qui est aberrante.

Quelle différence entre 4050 et 4051 ?

La 4050 signale un nombre de paramètres incorrect, la 4051 une valeur de paramètre invalide. Les codes 4062 à 4065 concernent, eux, le type de paramètre attendu.

Faut-il réessayer après une erreur 4051 ?

Non. Le même appel avec les mêmes valeurs sera refusé de la même manière. Il faut identifier la valeur aberrante et corriger le calcul ou le paramètre qui l’a produite.

Comment empêcher un EA de démarrer avec de mauvais réglages ?

Contrôlez les paramètres dans OnInit() et renvoyez INIT_PARAMETERS_INCORRECT si l’un d’eux est hors des limites prévues. L’EA ne démarre pas et l’utilisateur est averti.

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.