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

MQL5 · Bases du langage

Paramètres input et sinput en MQL5 : rendre un EA réglable et optimisable

Déclarer des paramètres externes avec input, exclure certains réglages de l’optimisation avec sinput, les regrouper avec input group et proposer des listes déroulantes grâce aux énumérations.

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

Le modificateur input transforme une variable globale en paramètre externe : sa valeur apparaît dans l’onglet « Paramètres » de la fenêtre des propriétés du programme et dans le Strategy Tester, où elle peut être optimisée. sinput (pour *static input*) crée aussi un paramètre réglable au lancement, mais que le testeur n’optimise pas. La règle à retenir : un paramètre input ou sinput se lit dans le code mais ne se modifie jamais par le code. Utilisez input pour ce que vous voulez optimiser (périodes, seuils, distances) et sinput pour ce qui ne doit pas l’être (magic number, commentaire d’ordre, options d’affichage).

Cette page fait partie de la rubrique Les bases du langage MQL5.

Syntaxe d’un paramètre input

Le modificateur se place devant le type, au niveau global du fichier :

input int    InpPeriodeMA = 50;     // Periode de la moyenne mobile
input double InpRisquePct = 1.0;    // Risque par trade (%)
input bool   InpFiltreSpread = true; // Activer le filtre de spread

Le commentaire placé en fin de ligne sert de libellé dans l’onglet des paramètres : l’utilisateur voit « Periode de la moyenne mobile » au lieu de InpPeriodeMA. La documentation limite ce commentaire à 63 caractères. Elle décrit aussi une forme explicite, input(name="MA period") int InpMAPeriod = 14;, qui accepte uniquement une chaîne littérale ; si les deux formes sont présentes, c’est la valeur de name qui l’emporte.

Les contraintes documentées sont les suivantes :

  • le nom de la variable est limité à 63 caractères ;
  • un tableau ou une variable de type complexe (structure, classe) ne peut pas être un paramètre input ;
  • la valeur d’un paramètre string est limitée à une longueur comprise entre 191 et 253 caractères selon la longueur du nom du paramètre ;
  • la valeur ne peut être modifiée que par l’utilisateur ; le programme peut la lire mais pas l’écrire.

Le préfixe Inp n’est pas obligatoire, mais c’est une convention répandue, y compris dans les exemples de MetaQuotes : il signale immédiatement au lecteur qu’il s’agit d’un paramètre externe.

Quand les valeurs sont-elles appliquées ?

Selon la documentation, les paramètres sont réinitialisés juste avant l’appel de OnInit(). Lorsque l’utilisateur modifie un paramètre sur un graphique, l’EA est désinitialisé avec le motif REASON_PARAMETERS, puis OnInit() est rappelée avec les nouvelles valeurs. C’est donc dans OnInit() qu’il faut vérifier la cohérence des paramètres.

sinput : un paramètre exclu de l’optimisation

sinput est équivalent à static input. Le paramètre reste modifiable au lancement de l’EA, mais dans le Strategy Tester les champs « Début », « Pas » et « Fin » sont indisponibles : le testeur ne fait jamais varier sa valeur. La documentation signale une seule exception : la fonction ParameterSetRange(), appelée dans OnTesterInit(), permet malgré tout de définir une plage d’optimisation pour un sinput.

Pourquoi est-ce utile ? Parce qu’une optimisation génétique sur 15 paramètres dont 5 n’ont aucun sens à optimiser (magic number, couleur, texte du commentaire) gaspille du temps de calcul et pollue l’interface. Marquer ces paramètres en sinput rend l’intention explicite et évite les fausses manipulations. Le fonctionnement de l’optimiseur est détaillé dans Optimisation génétique.

Organiser les paramètres avec input group

Au-delà de dix paramètres, l’onglet devient illisible. La directive input group "Nom du groupe" ouvre un bloc qui reste actif jusqu’au input group suivant. Dans la fenêtre des propriétés, les paramètres apparaissent sous des en-têtes ; dans le Strategy Tester, la documentation précise qu’un groupe peut être replié ou déplié, et qu’une case permet de sélectionner tous ses paramètres pour l’optimisation.

Un découpage efficace pour un EA suit la logique du code : « Signal », « Gestion du risque », « Filtres », « Identification ».

Paramètres de type énumération

Une énumération déclarée par vos soins peut servir de type à un paramètre. Chaque valeur apparaît alors dans une liste déroulante, et le commentaire placé après chaque membre de l’énumération remplace son nom technique dans la liste. C’est la meilleure façon de proposer un choix fermé (mode de calcul du lot, sens autorisé, type de stop) sans risquer une saisie invalide. Les énumérations intégrées, comme ENUM_TIMEFRAMES ou ENUM_MA_METHOD, fonctionnent de la même manière. La création d’énumérations est détaillée dans Énumérations (enum) personnalisées.

Pour un script, les paramètres ne s’affichent pas automatiquement : il faut ajouter #property script_show_inputs.

Exemple complet : un EA aux paramètres bien organisés

//+------------------------------------------------------------------+
//| Parametres organises : groupes, enum, input et sinput            |
//+------------------------------------------------------------------+
enum ENUM_MODE_LOT
  {
   LOT_FIXE   = 0,   // Lot fixe
   LOT_RISQUE = 1    // Lot calcule selon le risque
  };

input group "Signal"
input int             InpPeriodeRapide = 10;            // Periode MA rapide
input int             InpPeriodeLente  = 50;            // Periode MA lente
input ENUM_TIMEFRAMES InpTimeframe     = PERIOD_H1;     // Unite de temps du signal

input group "Gestion du risque"
input ENUM_MODE_LOT   InpModeLot   = LOT_RISQUE;        // Mode de calcul du lot
input double          InpLotFixe   = 0.10;              // Lot fixe
input double          InpRisquePct = 1.0;               // Risque par trade (%)
input int             InpStopPts   = 300;               // Stop loss (points)

input group "Identification"
sinput ulong          InpMagic       = 240501;          // Magic number
sinput string         InpCommentaire = "EA croisement"; // Commentaire des ordres

int OnInit()
  {
   // Les parametres ne sont pas modifiables : on les valide et on refuse si incoherents
   if(InpPeriodeRapide <= 0 || InpPeriodeRapide >= InpPeriodeLente)
     {
      Print("Parametres invalides : la periode rapide doit etre > 0 et < periode lente");
      return(INIT_PARAMETERS_INCORRECT);
     }
   if(InpRisquePct <= 0.0 || InpRisquePct > 5.0)
     {
      Print("Risque par trade hors limites (0 a 5 %)");
      return(INIT_PARAMETERS_INCORRECT);
     }

   // Pour adapter une valeur, on copie le parametre dans une variable de travail
   double lotInitial = (InpModeLot == LOT_FIXE) ? InpLotFixe : 0.0;
   PrintFormat("Mode %s, lot initial %.2f, magic %I64u",
               EnumToString(InpModeLot), lotInitial, InpMagic);
   return(INIT_SUCCEEDED);
  }

void OnTick()
  {
   // Logique de trading...
  }

Deux points méritent l’attention. D’abord, la validation dans OnInit() renvoie INIT_PARAMETERS_INCORRECT : en optimisation, la documentation indique que la passe correspondante est rejetée sans nouvelle tentative, ce qui évite de tester des combinaisons absurdes comme une moyenne rapide plus lente que la lente. Ensuite, quand une valeur doit être ajustée (par exemple un lot arrondi au pas du symbole), on la copie dans une variable de travail au lieu de tenter de modifier le paramètre.

Choisir le bon type pour chaque paramètre

Le type d’un paramètre conditionne ce que l’utilisateur peut saisir et la manière dont le testeur l’optimise. Quelques règles simples :

  • Périodes, distances en points, nombre de barres : int. Le testeur propose alors des pas entiers, ce qui évite des valeurs comme 14,37 barres.
  • Lots, pourcentages, multiplicateurs d’ATR : double. Pensez à fixer un pas d’optimisation raisonnable (0,1 ou 0,25) pour limiter le nombre de combinaisons.
  • Activation d’un filtre : bool. Le testeur peut optimiser un booléen, ce qui permet de mesurer l’apport réel d’un filtre.
  • Unité de temps : ENUM_TIMEFRAMES plutôt qu’un entier, pour obtenir une liste déroulante lisible.
  • Heures de session : deux int (heure et minute) sont plus faciles à optimiser qu’une chaîne "09:30", qu’il faudrait de toute façon convertir.
  • Magic number : ulong ou long en sinput, jamais optimisé.

Un paramètre bien typé est aussi un paramètre plus difficile à mal régler : l’utilisateur ne peut pas saisir de texte dans un champ numérique, et une énumération interdit toute valeur hors liste.

Pièges et bonnes pratiques

  • Modifier un input dans le code : le compilateur le refuse. Copiez la valeur dans une variable globale ordinaire si vous devez l’ajuster.
  • Optimiser le magic number : cela n’a aucun sens et multiplie les passes. Utilisez sinput. Le rôle du magic number est expliqué dans Le magic number.
  • Paramètres en points ou en prix : précisez toujours l’unité dans le libellé (« points », « % », « minutes »). Une distance de 30 peut signifier 30 points ou 3 pips selon le nombre de décimales du symbole.
  • Trop de paramètres optimisables : chaque paramètre supplémentaire augmente le risque de sur-optimisation. Optimisez peu de paramètres, figez les autres en sinput, et validez hors échantillon. Le sujet est développé dans Sur-optimisation.
  • Changer un paramètre sur un EA en cours : cela déclenche une réinitialisation complète, donc la perte des variables globales. Prévoyez la reconstruction de l’état dans OnInit().

FAQ

Peut-on modifier la valeur d’un input pendant l’exécution ?

Non. Le programme peut lire un paramètre input mais pas l’écrire : seul l’utilisateur peut le changer, et chaque changement provoque une réinitialisation de l’EA. Copiez la valeur dans une variable ordinaire si vous devez la transformer.

Quelle est la différence entre input et sinput ?

Les deux créent un paramètre réglable au lancement. Un paramètre sinput n’est en revanche pas optimisable dans le Strategy Tester : ses champs de plage sont désactivés, sauf si vous utilisez ParameterSetRange() dans OnTesterInit().

Comment afficher une liste déroulante dans les paramètres ?

Déclarez une énumération et utilisez-la comme type du paramètre input. Chaque membre devient une option, et le commentaire placé après chaque membre sert de libellé dans la liste.

Pourquoi mon script n’affiche-t-il pas ses paramètres ?

Un script n’ouvre pas la fenêtre des paramètres par défaut. Ajoutez la directive #property script_show_inputs en tête du fichier principal.

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.