MQL5 · Ordres et positions
Calculer et normaliser la taille de lot en MQL5 selon le risque
Convertir un risque en pourcentage en volume valide : perte par lot avec OrderCalcProfit ou tick value, arrondi au pas, bornes minimum et maximum, contrôle de marge. Code MQL5 complet.
Pour calculer la taille de lot en MQL5 à partir d’un risque, divisez le montant que vous acceptez de perdre par la perte que produirait un lot jusqu’au stop loss. Cette perte par lot s’obtient soit avec OrderCalcProfit entre le prix d’entrée et le stop, soit avec la formule distance du stop / SYMBOL_TRADE_TICK_SIZE × SYMBOL_TRADE_TICK_VALUE_LOSS. Le volume obtenu doit ensuite être normalisé : arrondi vers le bas au multiple de SYMBOL_VOLUME_STEP, puis borné entre SYMBOL_VOLUME_MIN et SYMBOL_VOLUME_MAX. Sans cette étape, le serveur refuse l’ordre avec TRADE_RETCODE_INVALID_VOLUME (10014).
Cette page traite de la traduction du risque en volume valide. Le choix du pourcentage de risque lui-même relève de la gestion du risque, développée dans Calculer la taille de position. Elle fait partie de la rubrique Ordres et positions en MQL5.
Les propriétés du symbole à connaître
| Propriété | Type | Rôle |
|---|---|---|
SYMBOL_VOLUME_MIN | double | volume minimal d’une transaction |
SYMBOL_VOLUME_MAX | double | volume maximal d’une transaction |
SYMBOL_VOLUME_STEP | double | pas minimal de variation du volume |
SYMBOL_VOLUME_LIMIT | double | volume total maximal des positions et ordres dans un même sens (0 = pas de limite) |
SYMBOL_TRADE_TICK_SIZE | double | variation minimale du prix |
SYMBOL_TRADE_TICK_VALUE_LOSS | double | valeur calculée d’un tick pour une position perdante |
SYMBOL_TRADE_TICK_VALUE_PROFIT | double | valeur calculée d’un tick pour une position gagnante |
SYMBOL_TRADE_TICK_VALUE | double | égale à la valeur de SYMBOL_TRADE_TICK_VALUE_PROFIT selon la documentation |
Ces valeurs sont exprimées dans la devise du compte pour un lot. La lecture des propriétés de symbole est présentée en détail dans SymbolInfoDouble, SymbolInfoInteger.
Notez la distinction entre valeur du tick en perte et en gain : la documentation les définit séparément, et elles peuvent différer, notamment quand la devise de cotation du symbole n’est pas celle du compte. Pour dimensionner sur un stop loss, la valeur en perte est la plus cohérente.
Méthode 1 : la formule tick size / tick value
La perte d’un lot entre l’entrée et le stop vaut :
perte_par_lot = (|entrée − stop| / tick_size) × tick_value_loss
et le volume brut :
lots = risque_en_argent / perte_par_lot
avec risque_en_argent = solde (ou fonds propres) × pourcentage de risque / 100. Utiliser la taille du tick plutôt que le point est important : sur certains instruments, comme des indices ou des matières premières, le pas de cotation n’est pas égal au point.
Méthode 2 : OrderCalcProfit
bool OrderCalcProfit(ENUM_ORDER_TYPE action, string symbol, double volume, double price_open, double price_close, double& profit) calcule, en devise du compte, le résultat d’une opération entre deux prix, pour le compte et les conditions de marché actuels. En passant le prix d’entrée, le prix du stop et un volume de 1 lot, vous obtenez directement la perte par lot (valeur négative). La documentation précise que la fonction est prévue pour évaluer à l’avance le résultat d’une opération et que la valeur estimée dépend de nombreux facteurs. En cas d’échec, elle renvoie false et GetLastError() donne le code.
Cette méthode délègue au terminal la conversion de devises, ce qui la rend pratique pour les symboles croisés. Les deux méthodes doivent donner des résultats très proches ; comparer les deux lors des tests est un bon moyen de détecter une erreur de calcul.
Normaliser le volume
Le volume brut est rarement valide. La normalisation suit trois règles :
- Arrondir vers le bas au pas :
MathFloor(lots / step) × step. Arrondir vers le bas garantit de ne jamais dépasser le risque prévu ; un arrondi au plus proche pourrait l’augmenter. - Respecter le minimum : si le résultat est inférieur à
SYMBOL_VOLUME_MIN, ne pas le relever automatiquement au minimum, car le risque réel dépasserait alors le risque prévu. Renoncez à l’entrée, ou acceptez explicitement ce dépassement par un paramètre. - Respecter le maximum : plafonner à
SYMBOL_VOLUME_MAX, et tenir compte deSYMBOL_VOLUME_LIMITs’il est non nul. Le dépassement de cette dernière limite est refusé avecTRADE_RETCODE_LIMIT_VOLUME(10034).
Les erreurs d’arrondi des nombres à virgule flottante peuvent produire un volume comme 0.30000000000000004 ; un NormalizeDouble final sur un nombre de décimales cohérent avec le pas évite ce problème. Voir NormalizeDouble et précision des prix.
Exemple complet : du risque au volume valide
//+------------------------------------------------------------------+
//| Taille de lot selon le risque, avec normalisation |
//+------------------------------------------------------------------+
input double InpRiskPercent = 1.0; // risque par trade (% des fonds propres)
//--- nombre de décimales du pas de volume (0.01 -> 2, 0.1 -> 1, 1 -> 0)
int StepDigits(double step)
{
int d = 0;
while(d < 8 && MathAbs(step * MathPow(10, d) - MathRound(step * MathPow(10, d))) > 1e-9)
d++;
return(d);
}
//--- perte pour 1 lot entre entry et sl (valeur positive, devise du compte)
double LossPerLot(const string symbol, ENUM_ORDER_TYPE type, double entry, double sl)
{
double profit = 0.0;
if(OrderCalcProfit(type, symbol, 1.0, entry, sl, profit))
return(MathAbs(profit));
//--- repli : formule tick size / tick value
double tick_size = SymbolInfoDouble(symbol, SYMBOL_TRADE_TICK_SIZE);
double tick_loss = SymbolInfoDouble(symbol, SYMBOL_TRADE_TICK_VALUE_LOSS);
if(tick_size <= 0.0 || tick_loss <= 0.0) return(0.0);
return(MathAbs(entry - sl) / tick_size * tick_loss);
}
//--- volume normalisé pour risquer InpRiskPercent ; 0 si impossible
double LotsForRisk(const string symbol, ENUM_ORDER_TYPE type, double entry, double sl)
{
double risk_money = AccountInfoDouble(ACCOUNT_EQUITY) * InpRiskPercent / 100.0;
double per_lot = LossPerLot(symbol, type, entry, sl);
if(per_lot <= 0.0) return(0.0);
double vmin = SymbolInfoDouble(symbol, SYMBOL_VOLUME_MIN);
double vmax = SymbolInfoDouble(symbol, SYMBOL_VOLUME_MAX);
double step = SymbolInfoDouble(symbol, SYMBOL_VOLUME_STEP);
double limit = SymbolInfoDouble(symbol, SYMBOL_VOLUME_LIMIT);
double lots = risk_money / per_lot;
if(step > 0.0) lots = MathFloor(lots / step + 1e-9) * step; // arrondi vers le bas
lots = NormalizeDouble(lots, StepDigits(step));
if(lots < vmin)
{
PrintFormat("Volume calculé %.4f < minimum %.2f : entrée refusée", lots, vmin);
return(0.0);
}
if(lots > vmax) lots = vmax;
if(limit > 0.0 && lots > limit) lots = limit; // contrôle simple, hors positions existantes
return(lots);
}
void OnStart()
{
double ask = SymbolInfoDouble(_Symbol, SYMBOL_ASK);
double bid = SymbolInfoDouble(_Symbol, SYMBOL_BID);
double sl = bid - 300 * _Point; // stop d'exemple
double lots = LotsForRisk(_Symbol, ORDER_TYPE_BUY, ask, sl);
PrintFormat("Risque %.1f %% -> %.2f lot (perte par lot %.2f %s)",
InpRiskPercent, lots, LossPerLot(_Symbol, ORDER_TYPE_BUY, ask, sl),
AccountInfoString(ACCOUNT_CURRENCY));
}
Le calcul utilise le prix d’entrée (Ask pour un achat) et le niveau du stop : la perte ainsi calculée inclut le spread payé à l’entrée, ce qui correspond au risque réel si le stop est touché. Le contrôle de SYMBOL_VOLUME_LIMIT est simplifié ; pour un contrôle exact, soustrayez le volume déjà engagé dans le même sens, en parcourant positions et ordres.
Exemple chiffré
Prenons un compte dont les fonds propres valent 10 000 dans la devise du compte, un risque de 1 %, soit 100 de perte acceptée, et un stop placé 300 points sous l’entrée sur une paire cotée avec 5 décimales. Si le tick vaut un point et que la valeur du tick en perte est de 1 pour un lot, la perte par lot jusqu’au stop est de 300. Le volume brut vaut 100 / 300 = 0,333 lot. Avec un pas de 0,01, l’arrondi vers le bas donne 0,33 lot, soit un risque effectif de 99, légèrement inférieur au risque visé. Ces valeurs de tick sont illustratives : lisez toujours celles de votre symbole.
Vérifier la marge
Un volume correct du point de vue du risque peut dépasser la marge disponible, surtout avec un stop serré. Avant l’envoi, vérifiez la marge requise avec OrderCalcMargin ou, mieux, validez la requête complète avec OrderCheck. Si la marge manque, le serveur répond TRADE_RETCODE_NO_MONEY (10019).
Cas d’usage et pièges
Solde ou fonds propres ? Calculer le risque sur les fonds propres (ACCOUNT_EQUITY) réduit automatiquement la taille quand des positions ouvertes sont en perte ; le solde (ACCOUNT_BALANCE) l’ignore. Choisissez en connaissance de cause et documentez ce choix.
Stops très serrés. Un stop de quelques points produit mécaniquement un volume énorme. Ajoutez un plafond de volume ou de levier dans l’EA, indépendamment du calcul de risque. L’intégration complète dans un EA est décrite dans Intégrer la gestion du risque.
Petit compte. Avec un faible capital, le volume calculé tombe souvent sous le minimum. Relever silencieusement au minimum multiplie le risque réel : mieux vaut refuser l’entrée.
Coûts non inclus. La commission et le swap ne sont pas inclus dans le calcul ci-dessus. Sur un compte à commission, réduisez légèrement le risque visé ou intégrez la commission par lot dans la perte par lot.
FAQ
Pourquoi le serveur renvoie-t-il 10014 Invalid volume ?
Le volume n’est pas un multiple de SYMBOL_VOLUME_STEP, ou il sort des bornes SYMBOL_VOLUME_MIN et SYMBOL_VOLUME_MAX. Normalisez-le comme dans l’exemple avant l’envoi.
Faut-il utiliser SYMBOL_TRADE_TICK_VALUE ou SYMBOL_TRADE_TICK_VALUE_LOSS ?
Pour dimensionner sur un stop loss, la valeur du tick en perte est la plus adaptée. Selon la documentation, SYMBOL_TRADE_TICK_VALUE est égale à la valeur du tick en gain.
Pourquoi arrondir vers le bas plutôt qu’au plus proche ?
Pour ne jamais dépasser le risque prévu. Un arrondi au plus proche peut augmenter le volume d’un pas et donc le risque réel.
Comment vérifier que mon calcul est juste ?
Affichez, pour un stop donné, la perte par lot calculée par les deux méthodes et comparez-la à la perte réellement enregistrée sur un trade de démonstration arrêté par son stop (somme de DEAL_PROFIT du deal de sortie). Les trois valeurs doivent être très proches, à l’écart de glissement près.
- Ordres, positions et transactions : le modèle de MT5
- Comptes netting ou hedging
- La classe CTrade
- OrderSend et MqlTradeRequest
- OrderCheck : vérifier un ordre avant envoi
- Ouvrir une position au marché
- Ordres limites et stop
- Placer et modifier stop loss et take profit
- Coder un trailing stop
- Passer une position à break-even
- Fermer une position (totale ou partielle)
- Parcourir et filtrer les positions
- Le magic number
- Lire l’historique des ordres et transactions
- OnTradeTransaction : réagir aux événements de trading
- Modes de remplissage (FOK, IOC, Return)
- Gérer spread et slippage dans un EA
