MQL5 · Codes d’erreur
Erreur 10019 No money en MQL5 : contrôler la marge avant d’envoyer
Le retcode 10019 signale une marge libre insuffisante pour l’ordre. Calcul avec OrderCalcMargin, contrôle par OrderCheck et adaptation du volume dans un EA MQL5.
Le code 10019 (TRADE_RETCODE_NO_MONEY, libellé officiel « There is not enough money to complete the request ») signifie que la marge libre de votre compte ne suffit pas à couvrir la marge exigée par l’ordre. Ce n’est pas une erreur de syntaxe mais une limite financière : le serveur refuse d’ouvrir une position que le compte ne peut pas supporter. MQL5 permet de prévoir ce refus avant l’envoi, en calculant la marge nécessaire avec OrderCalcMargin() ou en soumettant la requête à OrderCheck(). La bonne réaction n’est jamais de réessayer à l’identique, mais de réduire le volume ou de renoncer au trade.
Cette page explique comment la marge est évaluée, d’où viennent les 10019 inattendus et comment intégrer un contrôle de marge à votre EA. Elle fait partie de la rubrique Codes d’erreur et de retour MQL5.
Marge requise et marge libre
Lorsqu’on ouvre une position à effet de levier, le courtier immobilise une partie des fonds, la marge. Deux grandeurs comptent :
- la marge requise par le nouvel ordre, qui dépend du symbole, du volume, du prix, du levier et des règles de calcul du courtier pour cet instrument ;
- la marge libre du compte (
ACCOUNT_MARGIN_FREE), c’est-à-dire les fonds propres (equity) moins la marge déjà utilisée par les positions ouvertes.
Si la marge requise dépasse la marge libre, le serveur répond 10019. Point important : la marge libre dépend des fonds propres, donc des pertes et gains latents. Un compte dont les positions ouvertes perdent voit sa marge libre fondre, et un ordre accepté le matin peut être refusé l’après-midi avec le même volume.
Un exemple chiffré
Prenons un compte de 2 000 euros, avec un effet de levier de 1:30 sur les paires de devises, et un contrat standard de 100 000 unités. Pour acheter 1 lot d’EURUSD autour de 1,08, la valeur notionnelle est d’environ 108 000 dollars, soit à peu près 100 000 euros ; la marge requise est d’environ un trentième, soit 3 300 euros environ. Le serveur répond 10019 : la marge libre de 2 000 euros ne suffit pas.
Réduisons à 0,30 lot : la marge requise tombe à environ 1 000 euros, ce qui passe. Mais si le compte a déjà une position ouverte de 0,20 lot en perte latente de 300 euros, la marge libre n’est plus que d’environ 1 000 euros : le nouvel ordre est à la limite, et la moindre variation le fera refuser. Ces chiffres sont illustratifs ; les règles réelles de calcul dépendent du courtier et du symbole, d’où l’intérêt de laisser OrderCalcMargin() faire le calcul plutôt que de le coder vous-même.
Calculer la marge avant l’envoi
OrderCalcMargin() calcule la marge nécessaire pour un type d’ordre, un symbole, un volume et un prix donnés, dans la devise du compte :
bool OrderCalcMargin(
ENUM_ORDER_TYPE action, // type d'ordre (ORDER_TYPE_BUY ou ORDER_TYPE_SELL)
string symbol, // symbole
double volume, // volume en lots
double price, // prix d'ouverture
double& margin // marge calculée, en devise du compte
);
Si le calcul échoue, la fonction renvoie false ; GetLastError() peut alors indiquer 4758 (ERR_TRADE_CALC_FAILED, « Failed to calculate profit or margin »), par exemple si les données du symbole ne sont pas encore disponibles.
Une fonction qui adapte le volume à la marge disponible
L’exemple suivant vérifie qu’un volume tient dans la marge libre en gardant une réserve de sécurité, et le réduit si nécessaire. La réserve évite d’utiliser toute la marge libre, ce qui placerait le compte au bord d’un appel de marge au moindre mouvement défavorable.
input double InpMarginReservePct = 50.0; // % de la marge libre à ne jamais engager
//+------------------------------------------------------------------+
//| Renvoie le volume maximal compatible avec la marge disponible |
//| (ne dépasse jamais le volume demandé). 0.0 si impossible. |
//+------------------------------------------------------------------+
double FitVolumeToMargin(const string symbol, const ENUM_ORDER_TYPE type, double lots)
{
MqlTick t;
if(!SymbolInfoTick(symbol, t))
return 0.0;
double price = (type == ORDER_TYPE_BUY) ? t.ask : t.bid;
double freeMargin = AccountInfoDouble(ACCOUNT_MARGIN_FREE);
double usable = freeMargin * (1.0 - InpMarginReservePct / 100.0);
double vMin = SymbolInfoDouble(symbol, SYMBOL_VOLUME_MIN);
double vStep = SymbolInfoDouble(symbol, SYMBOL_VOLUME_STEP);
// On descend pas à pas jusqu'à ce que la marge tienne
while(lots >= vMin)
{
double margin = 0.0;
ResetLastError();
if(!OrderCalcMargin(type, symbol, lots, price, margin))
{
PrintFormat("OrderCalcMargin a échoué, erreur %d", GetLastError());
return 0.0;
}
if(margin <= usable)
return lots;
lots = NormalizeDouble(lots - vStep, 2);
}
PrintFormat("Marge insuffisante : libre %.2f, utilisable %.2f, même au volume minimal",
freeMargin, usable);
return 0.0;
}
Deux remarques. La décrémentation pas à pas est simple et lisible ; pour de gros volumes, on peut d’abord estimer le résultat par une règle de trois sur la marge d’un lot, puis affiner. Et l’arrondi NormalizeDouble(..., 2) suppose un pas de 0,01 : sur un symbole au pas différent, utilisez la normalisation décrite dans 10014 Volume invalide.
Le contrôle complet avec OrderCheck
OrderCheck() va plus loin que le seul calcul de marge : il évalue la requête complète et remplit une structure MqlTradeCheckResult qui contient notamment retcode, margin (la marge requise), margin_free (la marge libre restante après l’opération) et margin_level. La documentation précise que la fonction renvoie false en cas de fonds insuffisants ou de paramètres mal renseignés. C’est l’outil idéal pour obtenir un 10019 sans rien envoyer au serveur, avec en prime la marge libre qui resterait après l’opération. La page OrderCheck : vérifier un ordre avant envoi en montre l’usage.
D’où viennent les 10019 inattendus
Un calcul de lot qui ignore la marge
Un calcul de taille de position fondé uniquement sur le risque (pourcentage du capital et distance du stop) peut produire un volume énorme si le stop est très serré. Le risque théorique est respecté, mais la marge requise dépasse les fonds. Combinez toujours les deux contraintes : risque et marge. La méthode de calcul est présentée dans Calculer et normaliser la taille de lot.
Des positions qui s’accumulent
Un EA qui ouvre une nouvelle position à chaque signal sans limite de nombre finit par consommer toute la marge. Plafonnez le nombre de positions simultanées et l’exposition totale.
Des exigences de marge variables
Certains courtiers augmentent la marge exigée à l’approche du week-end, d’un événement majeur ou sur certains instruments volatils. Un volume habituel peut alors être refusé. Recalculer la marge au moment de l’envoi, au lieu de la supposer constante, évite cette surprise.
La devise du compte
La marge est exprimée dans la devise du compte. Sur un compte en euros qui trade de l’USDJPY, elle varie aussi avec le taux de change entre l’euro et le dollar. Ne codez jamais une marge « par lot » en dur.
Réagir à un 10019 en production
- Ne pas réessayer le même volume : la marge ne va pas augmenter d’elle-même dans la seconde.
- Réduire ou renoncer selon votre politique : la fonction ci-dessus renvoie un volume réduit, mais c’est à votre stratégie de décider si un trade de taille réduite garde du sens.
- Journaliser la marge requise, la marge libre et le niveau de marge (
ACCOUNT_MARGIN_LEVEL) pour comprendre la situation. - Alerter si le phénomène se répète : un compte régulièrement à court de marge est un compte surexposé.
Questions fréquentes
Pourquoi un 10019 alors que mon solde est largement suffisant ?
Le serveur compare la marge requise à la marge libre, pas au solde. Les pertes latentes des positions ouvertes et la marge qu’elles immobilisent réduisent la marge libre. Lisez ACCOUNT_MARGIN_FREE pour connaître la valeur réellement disponible.
OrderCalcMargin tient-il compte de mes positions ouvertes ?
Il calcule la marge requise pour l’ordre indiqué. Pour savoir ce qui resterait après l’opération, compte tenu du compte entier, utilisez OrderCheck() et lisez margin_free dans MqlTradeCheckResult.
Faut-il réduire automatiquement le volume après un 10019 ?
C’est une option, à condition que votre stratégie l’accepte. Un trade de taille réduite modifie le profil de risque et de rendement ; certains préfèrent renoncer purement et simplement.
Le testeur de stratégie produit-il des 10019 ?
Oui, il simule la marge selon le dépôt initial et le levier choisis. Un backtest avec un dépôt irréaliste peut masquer ce problème ; testez avec un capital proche de celui que vous utiliserez.
- 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
- 10014 Volume invalide
- 10015 Prix invalide
- 10016 Stops invalides
- 10017 Trading désactivé
- 10018 Marché fermé
- 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
