MQL5 · Codes d’erreur
Erreur 10014 Invalid volume en MQL5 : normaliser la taille de lot
Le retcode 10014 signale un volume hors des règles du symbole. Volume minimal, maximal et pas : comprendre le refus et normaliser chaque lot avant envoi.
Le code 10014 (TRADE_RETCODE_INVALID_VOLUME, libellé officiel « Invalid volume in the request ») signifie que le volume de votre ordre ne respecte pas les règles du symbole chez votre courtier. Trois propriétés fixent ces règles : le volume minimal (SYMBOL_VOLUME_MIN), le volume maximal (SYMBOL_VOLUME_MAX) et le pas de volume (SYMBOL_VOLUME_STEP). Un lot de 0,153 sur un symbole dont le pas est 0,01, un lot de 0,005 quand le minimum est 0,01, ou un lot de 200 quand le maximum est 100 produisent tous ce refus. La solution est de normaliser systématiquement le volume calculé avant tout envoi.
Cette page explique d’où viennent ces volumes invalides, comment les détecter et propose une fonction de normalisation robuste. Elle fait partie de la rubrique Codes d’erreur et de retour MQL5.
Les propriétés qui définissent un volume valide
Toutes se lisent avec SymbolInfoDouble() :
| Propriété | Rôle | Exemple courant sur une paire forex |
|---|---|---|
SYMBOL_VOLUME_MIN | Volume minimal d’une transaction | 0,01 |
SYMBOL_VOLUME_MAX | Volume maximal d’une transaction | 50 ou 100 selon le courtier |
SYMBOL_VOLUME_STEP | Pas minimal de variation du volume | 0,01 |
SYMBOL_VOLUME_LIMIT | Volume cumulé maximal (position et ordres en attente) dans une direction | 0 si aucune limite |
Les exemples de la colonne de droite sont indicatifs : les valeurs varient d’un courtier et d’un symbole à l’autre. Sur un indice ou une action, le minimum peut être de 0,1 ou de 1, et le pas de 0,1 ou de 1. C’est précisément pour cette raison qu’un volume codé en dur, qui fonctionnait sur l’EURUSD, échoue dès qu’on lance l’EA sur le DAX.
Notez que SYMBOL_VOLUME_LIMIT correspond, lorsqu’elle est dépassée, à un code différent : 10034 (TRADE_RETCODE_LIMIT_VOLUME). Le 10014 concerne le volume d’une transaction isolée.
D’où viennent les volumes invalides
Le calcul de lot selon le risque
C’est la cause principale. Une formule de taille de position renvoie presque toujours un nombre « continu », par exemple 0,2374 lot. Sans arrondi au pas, l’ordre est refusé. Pire, si le capital est faible ou le stop très large, le résultat peut tomber sous le minimum. Le calcul lui-même est détaillé dans Calculer et normaliser la taille de lot ; cette page se concentre sur l’étape de validation.
L’imprécision des nombres à virgule
Même après un arrondi apparent, un double peut valoir 0,30000000000000004 au lieu de 0,3. Dans la plupart des cas, le serveur tolère cette imprécision, mais un calcul de type MathFloor(volume / step) * step peut aussi perdre un pas entier à cause d’une valeur comme 2,9999999. On corrige cela en ajoutant une petite marge avant l’arrondi inférieur ou en arrondissant au nombre de décimales du pas.
La clôture partielle
Fermer la moitié d’une position de 0,03 lot donne 0,015 lot : volume invalide si le pas est 0,01. Toute division du volume d’une position doit passer par la même normalisation. Si le volume demandé dépasse celui de la position, le code sera d’ailleurs 10038 (TRADE_RETCODE_INVALID_CLOSE_VOLUME).
Le multiplicateur de martingale ou de pyramidage
Un lot multiplié à chaque étape finit par dépasser SYMBOL_VOLUME_MAX. Au-delà du refus technique, c’est un signal de risque à prendre très au sérieux.
Une fonction de normalisation complète
//+------------------------------------------------------------------+
//| Ramène un volume brut à un volume valide pour le symbole |
//| Renvoie 0.0 si aucun volume valide n'est possible |
//+------------------------------------------------------------------+
double NormalizeVolume(const string symbol, double volume)
{
double vMin = SymbolInfoDouble(symbol, SYMBOL_VOLUME_MIN);
double vMax = SymbolInfoDouble(symbol, SYMBOL_VOLUME_MAX);
double vStep = SymbolInfoDouble(symbol, SYMBOL_VOLUME_STEP);
if(vMin <= 0.0 || vStep <= 0.0)
{
PrintFormat("%s : propriétés de volume indisponibles", symbol);
return 0.0;
}
// Arrondi INFÉRIEUR au pas : on ne prend jamais plus de risque que prévu.
// La marge 1e-8 évite de perdre un pas à cause d'un 2.9999999.
double steps = MathFloor(volume / vStep + 1e-8);
volume = steps * vStep;
// Nombre de décimales du pas (0.01 -> 2, 0.1 -> 1, 1 -> 0)
int digits = (int)MathMax(0, MathCeil(-MathLog10(vStep) - 1e-8));
volume = NormalizeDouble(volume, digits);
if(volume < vMin)
{
PrintFormat("%s : volume %.4f inférieur au minimum %.2f, ordre abandonné",
symbol, volume, vMin);
return 0.0; // on ne force PAS le minimum : cela augmenterait le risque
}
if(volume > vMax)
volume = vMax; // plafonnement au maximum autorisé
return volume;
}
Deux choix de conception sont délibérés. L’arrondi se fait vers le bas, pour que le risque réel ne dépasse jamais le risque calculé. Et lorsqu’un volume tombe sous le minimum, la fonction renvoie 0 au lieu de forcer le minimum : forcer 0,01 lot quand votre calcul en demandait 0,004 revient à multiplier le risque par 2,5. C’est à la stratégie de décider si elle accepte ce surcroît de risque, pas à une fonction utilitaire de le faire en silence.
Trois exemples chiffrés
Supposons un symbole avec un minimum de 0,01, un pas de 0,01 et un maximum de 50 :
- Un calcul de risque renvoie 0,2374 lot. Divisé par le pas, on obtient 23,74 pas, arrondis à 23 : le volume envoyé est 0,23 lot. Le risque réel est légèrement inférieur au risque visé, ce qui est acceptable.
- Un calcul renvoie 0,0068 lot. Après arrondi, on obtient 0 pas, donc un volume nul, inférieur au minimum : la fonction renvoie 0 et l’EA s’abstient. Si vous voyez souvent ce cas, votre stop est trop large pour votre capital, ou votre pourcentage de risque trop faible pour ce symbole.
- Un calcul renvoie 73,5 lots. Le volume est plafonné à 50. Ce plafonnement doit alerter : un tel résultat traduit généralement une erreur de calcul, par exemple un stop exprimé en prix au lieu de points.
Prenez maintenant un indice avec un minimum de 0,1 et un pas de 0,1. Le même 0,2374 devient 0,2 lot, et 0,0068 est abandonné. On voit combien la granularité du symbole modifie le risque effectivement pris.
Utilisation dans l’EA
#include <Trade\Trade.mqh>
CTrade trade;
void OpenBuy(const double rawLots)
{
double lots = NormalizeVolume(_Symbol, rawLots);
if(lots <= 0.0)
return; // trop petit : on s'abstient
if(!trade.Buy(lots))
PrintFormat("Buy %.2f : retcode %u %s", lots,
trade.ResultRetcode(), trade.ResultRetcodeDescription());
}
Diagnostiquer un 10014 dans le journal
Quand le refus apparaît, imprimez quatre nombres côte à côte : le volume envoyé avec au moins six décimales, et les trois propriétés min, max et pas. La comparaison suffit dans presque tous les cas. Un volume affiché « 0.10 » avec deux décimales peut cacher 0,1000001 : utilisez un format %.8f pendant le diagnostic.
Vérifiez aussi le symbole utilisé pour lire les propriétés. Un EA multi-symboles qui lit _Symbol alors qu’il trade un autre instrument normalise selon de mauvaises règles. Les propriétés de chaque symbole sont présentées dans SymbolInfoDouble, SymbolInfoInteger.
Contrôler avant d’envoyer
OrderCheck() détecte un volume invalide sans rien envoyer au serveur : le champ retcode de MqlTradeCheckResult contient alors 10014. C’est un bon réflexe pour toute fonction d’envoi générique, d’autant qu’il signale aussi un problème de marge dans le même appel. Voyez OrderCheck : vérifier un ordre avant envoi.
Pièges fréquents
- Tester uniquement sur EURUSD. Les règles de volume y sont standard ; elles ne le sont pas sur les indices, matières premières et actions.
- Confondre lot et unités. Le volume MQL5 s’exprime en lots, dont la taille dépend du contrat (
SYMBOL_TRADE_CONTRACT_SIZE). Ne mélangez pas les deux dans vos calculs. - Réessayer après un 10014. Le même volume sera refusé à l’identique ; il faut corriger le calcul.
- Oublier les ordres en attente. Un ordre limite avec un volume non normalisé est refusé de la même façon qu’un ordre au marché.
SYMBOL_VOLUME_MAX ne protège pas votre capital : définissez un risque maximal par trade conforme à votre gestion du risque, et rappelez-vous que le trading à effet de levier peut entraîner des pertes rapides.Questions fréquentes
Pourquoi 0.1 lot est-il refusé alors que le minimum est 0.01 ?
Vérifiez le pas de volume et le maximum : si le pas est 0,1 et que votre valeur réelle est 0,1000001, ou si le symbole n’est pas celui que vous croyez, le refus est logique. Imprimez le volume avec huit décimales et les trois propriétés du bon symbole.
Faut-il arrondir au plus proche ou vers le bas ?
Vers le bas pour les ouvertures, afin que le risque réel ne dépasse pas le risque prévu. Pour une clôture partielle, l’arrondi au plus proche peut se justifier, tant que le résultat reste inférieur ou égal au volume de la position.
Quelle différence entre 10014 et 10034 ?
10014 signale un volume invalide pour une transaction (min, max, pas). 10034 (TRADE_RETCODE_LIMIT_VOLUME) indique que la limite de volume cumulé du symbole, SYMBOL_VOLUME_LIMIT, est atteinte.
NormalizeDouble suffit-il à corriger le volume ?
Non, à lui seul il arrondit à un nombre de décimales, pas au pas du symbole. Avec un pas de 0,5 par exemple, NormalizeDouble(0.7, 1) reste 0,7, ce qui est invalide. Il faut d’abord ramener le volume à un multiple du pas.
- Erreurs de compilation MQL5
- Invalid pointer access
- GetLastError et gestion des erreurs
- Codes de retour du serveur de trading
- 10004 Requote
- 10006 Requête rejetée
- 10013 Requête invalide
- 10015 Prix invalide
- 10016 Stops invalides
- 10017 Trading désactivé
- 10018 Marché fermé
- 10019 Fonds insuffisants
- 10021 Pas de cotations
- 10024 Trop de requêtes
- 10027 Trading automatique désactivé
- 10030 Mode de remplissage non supporté
- 4756 Échec d’envoi de la requête
- Array out of range
- Division par zéro
