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

MQL4 · Codes d’erreur

Erreur 131 en MQL4 (ERR_INVALID_TRADE_VOLUME) : arrondir correctement la taille de lot

L’erreur 131 signale un volume refusé : lot sous le minimum, au-delà du maximum ou qui ne respecte pas le pas du symbole. Une fonction d’arrondi fiable la fait disparaître.

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

L’erreur 131, constante ERR_INVALID_TRADE_VOLUME, libellé *Invalid trade volume*, est renvoyée lorsque le nombre de lots transmis à OrderSend (ou à OrderClose pour une fermeture partielle) n’est pas accepté. Chaque symbole définit trois contraintes de volume, lisibles avec MarketInfo() : le volume minimal (MODE_MINLOT), le volume maximal (MODE_MAXLOT) et le pas de variation (MODE_LOTSTEP). Un volume valide est compris entre le minimum et le maximum et s’écrit comme un multiple exact du pas à partir du minimum.

L’erreur 131 apparaît rarement avec un lot fixe saisi à la main. Elle surgit dès que le volume est calculé : gestion du risque en pourcentage, martingale, fermeture partielle de la moitié d’une position. Le résultat d’un calcul en virgule flottante, par exemple 0,1347 lot, ne correspond à aucun volume négociable. C’est l’angle de cette page : produire un volume toujours valide.

Les trois contraintes du symbole

IdentifiantValeurSignification
MODE_MINLOT23Volume minimal autorisé
MODE_LOTSTEP24Pas de variation du volume
MODE_MAXLOT25Volume maximal autorisé par ordre

Ces valeurs varient d’un courtier à l’autre et d’un symbole à l’autre sur le même compte. Un pas de 0,01 est fréquent sur le forex, mais certains indices ou matières premières n’acceptent que des pas de 0,1 ou 1. Ne codez jamais ces valeurs en dur : lisez-les à chaque calcul. La page MarketInfo présente l’ensemble des propriétés disponibles.

Les causes typiques

  • Volume non arrondi : 0,1347 lot au lieu de 0,13.
  • Volume sous le minimum : un petit compte avec un risque de 1 % donne 0,004 lot, alors que le minimum est 0,01.
  • Volume au-dessus du maximum : une martingale qui double après chaque perte finit par dépasser MODE_MAXLOT.
  • Mauvais pas : 0,15 lot sur un symbole dont le pas est 0,1.
  • Volume nul ou négatif : une division mal protégée ou un stop nul dans la formule du risque. Selon la fonction et la valeur, le terminal peut alors signaler une erreur de paramètre plutôt qu’une 131 ; voir Erreur 4051 : paramètre invalide.
  • Fermeture partielle mal arrondie : OrderLots() / 2 sur 0,05 lot donne 0,025, refusé si le pas est 0,01.

Une fonction d’arrondi fiable

La fonction suivante ramène n’importe quel volume calculé à une valeur négociable. Elle arrondit vers le bas au pas, pour ne jamais prendre plus de risque que prévu, puis applique le minimum et le maximum. Le choix de renvoyer 0 lorsque le volume est sous le minimum est volontaire : forcer le minimum ferait dépasser le risque fixé.

//+------------------------------------------------------------------+
//| Ramène un volume calculé à une valeur acceptée par le symbole     |
//| Renvoie 0 si le volume est inférieur au minimum                  |
//+------------------------------------------------------------------+
#property strict

double NormalizeLots(const string sym, const double rawLots)
  {
   double minLot  = MarketInfo(sym, MODE_MINLOT);
   double maxLot  = MarketInfo(sym, MODE_MAXLOT);
   double step    = MarketInfo(sym, MODE_LOTSTEP);
   if(step <= 0 || minLot <= 0)
      return 0;                                   // propriétés indisponibles

   // nombre de pas entiers, arrondi vers le bas (petite tolérance flottante)
   double steps = MathFloor(rawLots / step + 1e-8);
   double lots  = steps * step;

   if(lots < minLot) return 0;                    // trop petit : on renonce
   if(lots > maxLot) lots = maxLot;               // plafonné au maximum

   // nombre de décimales du pas (0.01 -> 2, 0.1 -> 1, 1 -> 0)
   int decimals = 0;
   while(decimals < 8 && MathAbs(step * MathPow(10, decimals)
                                 - MathRound(step * MathPow(10, decimals))) > 1e-8)
      decimals++;

   return NormalizeDouble(lots, decimals);
  }

//--- exemple : fermeture partielle de la moitié d'un ordre sélectionné
bool CloseHalf(const int slippage)
  {
   double half = NormalizeLots(OrderSymbol(), OrderLots() / 2.0);
   if(half <= 0 || half >= OrderLots())
     {
      Print("Fermeture partielle impossible : volume trop faible");
      return false;
     }
   RefreshRates();
   double price = (OrderType() == OP_BUY) ? MarketInfo(OrderSymbol(), MODE_BID)
                                          : MarketInfo(OrderSymbol(), MODE_ASK);
   return OrderClose(OrderTicket(), half,
                     NormalizeDouble(price, (int)MarketInfo(OrderSymbol(), MODE_DIGITS)),
                     slippage, clrNONE);
  }

Deux détails méritent l’attention. La petite tolérance 1e-8 évite qu’un volume de 0,3 représenté en mémoire comme 0,29999999 soit arrondi à 0,29. Et le calcul du nombre de décimales à partir du pas garantit que la valeur transmise ne comporte pas de « queue » flottante, comme 0,13000000000000001.

Cas d’usage en trading

Risque en pourcentage

Avec un calcul du type « risquer 1 % du capital sur un stop de 250 points », le volume brut dépend du solde, de la valeur du tick et de la distance du stop. Il n’est pratiquement jamais un multiple du pas. Passez-le systématiquement dans NormalizeLots avant l’envoi. La méthode complète de calcul est décrite dans Taille de lot selon le risque, et les principes généraux dans Calculer la taille de position.

EA multi-paires

Un même EA qui trade l’EURUSD et l’or peut rencontrer des pas différents. Appelez la fonction avec le symbole de l’ordre (OrderSymbol() ou le symbole ciblé), jamais avec Symbol() par réflexe.

Volume supérieur au maximum

Plafonner au maximum évite l’erreur 131, mais cache parfois un problème : si votre calcul aboutit régulièrement au maximum, la logique de sizing est probablement défaillante (stop trop serré, compte trop grand pour une seule position). Journalisez ce cas plutôt que de le traiter en silence. Notez aussi qu’un volume valide peut être refusé faute de marge : c’est alors une erreur 134.

Vérifier un volume sans l’envoyer

Il est souvent utile de savoir si un volume est valide sans le modifier, par exemple pour refuser un paramètre saisi par l’utilisateur dès OnInit(). Le principe est simple : le volume doit être supérieur ou égal au minimum, inférieur ou égal au maximum, et la quantité (lots - minLot) / step doit être un entier, à une petite tolérance près. Si le contrôle échoue, renvoyez INIT_PARAMETERS_INCORRECT depuis OnInit() avec un message explicite : l’utilisateur corrige son réglage avant le premier tick, au lieu de découvrir une série d’erreurs 131 dans le journal plusieurs heures plus tard.

Ce contrôle a aussi sa place dans l’optimisation. Lorsque le testeur fait varier un paramètre de lot par pas de 0,05 sur un symbole dont le pas est 0,1, la moitié des passes échouent sans que les résultats ne le montrent clairement. Alignez le pas d’optimisation sur MODE_LOTSTEP, ou mieux, optimisez un pourcentage de risque et laissez NormalizeLots produire le volume.

Martingale, grille et volumes croissants

Les stratégies qui multiplient le volume après une perte rencontrent l’erreur 131 de deux façons. D’abord par les arrondis : 0,01 × 1,5 × 1,5 donne 0,0225, puis 0,03375, valeurs qu’il faut ramener au pas. Ensuite par le plafond : après une série de pertes, le volume théorique dépasse MODE_MAXLOT. À ce moment, l’erreur 131 (ou le plafonnement silencieux) signifie que la stratégie a atteint une limite matérielle, et que la progression prévue ne peut plus être appliquée. Traitez ce cas comme un signal d’arrêt et non comme un détail technique : c’est souvent là que se situe le risque de ruine de ce type d’approche.

Diagnostiquer dans le journal

Quand l’erreur 131 survient, enregistrez le volume exact envoyé avec une précision suffisante (DoubleToString(lots, 8)) ainsi que les trois propriétés du symbole. Une valeur comme 0.13000001 ou un pas de 0.1 inattendu révèle immédiatement la cause. La méthode de lecture du code est détaillée dans GetLastError en MQL4, et la liste des autres erreurs dans Codes d’erreur MQL4.

Un volume mal calculé peut exposer votre compte bien au-delà de ce que vous aviez prévu. Arrondissez toujours vers le bas et vérifiez le résultat en démonstration. Le trading sur marge comporte un risque de perte en capital.

Questions fréquentes

Pourquoi l’erreur 131 alors que mon lot est de 0,1 ?

Vérifiez le pas et le minimum du symbole avec MarketInfo. Certains symboles imposent un minimum supérieur à 0,1 ou un pas de 1. Vérifiez aussi la valeur réellement transmise : un calcul peut produire 0,1000000001 au lieu de 0,1.

Faut-il arrondir le lot vers le haut ou vers le bas ?

Vers le bas, pour ne pas dépasser le risque prévu. Arrondir vers le haut augmente la perte potentielle si le stop est atteint.

NormalizeDouble(lots, 2) suffit-il ?

Seulement si le pas du symbole est 0,01 et le volume compris entre le minimum et le maximum. Pour un pas de 0,1 ou un volume hors limites, il faut un arrondi au pas et des bornes, comme dans la fonction proposée.

Les propriétés de volume sont-elles les mêmes en démonstration et en réel ?

Pas forcément. Le minimum, le maximum et le pas peuvent différer d’un type de compte à l’autre chez le même courtier. C’est une raison de plus pour les lire avec MarketInfo à chaque calcul plutôt que de les fixer dans le code.

L’erreur 131 peut-elle survenir lors d’une fermeture ?

Oui, lors d’une fermeture partielle avec OrderClose si le volume à fermer n’est pas un multiple du pas ou si le reliquat est incohérent. Arrondissez le volume partiel de la même manière.

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.