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.
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
| Identifiant | Valeur | Signification |
|---|---|---|
MODE_MINLOT | 23 | Volume minimal autorisé |
MODE_LOTSTEP | 24 | Pas de variation du volume |
MODE_MAXLOT | 25 | Volume 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() / 2sur 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.
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.
- GetLastError en MQL4
- Erreur 129 : prix invalide
- Erreur 130 : stops invalides
- Erreur 133 : trading interdit
- Erreur 134 : fonds insuffisants
- Erreur 135 : prix modifié
- Erreur 136 : pas de prix
- Erreur 138 : requote
- Erreur 145 : modification refusée (trop proche)
- Erreur 146 : contexte de trading occupé
- Erreur 148 : trop d’ordres
- Erreur 4051 : paramètre invalide
- Erreur 4107 : prix invalide
- Erreur 4108 : ticket invalide
- Erreur 4109 : trading non autorisé
- Erreurs 4110 et 4111 : achats ou ventes non autorisés
- Erreurs de compilation MQL4
