MQL4 · Codes d’erreur
Codes d’erreur MQL4 : comprendre, diagnostiquer et corriger les erreurs de vos EA
Erreur 130, 134, 146 ou 4109 : chaque code MQL4 raconte une histoire précise. Cette rubrique classe les erreurs de MetaTrader 4, explique leur origine et montre comment les traiter dans le code.
Un Expert Advisor MQL4 qui « ne prend pas de position » ou qui s’arrête au milieu d’une modification de stop n’est presque jamais muet : le terminal lui a renvoyé un code d’erreur. Encore faut-il le lire, savoir d’où il vient et décider s’il faut réessayer, corriger un calcul ou prévenir l’utilisateur. Cette rubrique rassemble les codes que vous rencontrerez réellement en développant pour MetaTrader 4, avec pour chacun une page dédiée : la signification officielle, les causes concrètes, la façon de les reproduire et le code MQL4 pour les traiter proprement.
Les numéros et les noms de constantes cités dans ces pages sont ceux de la documentation officielle de MQL4 (sections *Trade Server Return Codes* et *Runtime Errors*). Lorsque la documentation reste muette sur une cause, nous le signalons et nous décrivons ce que l’on observe en pratique, sans le présenter comme une règle.
Deux familles d’erreurs à ne pas confondre
Les codes MQL4 se répartissent en deux grandes familles, et la distinction a des conséquences directes sur la manière de les traiter.
Les codes de retour du serveur de trading (0 à 150). Ils concernent les opérations de trading : OrderSend, OrderModify, OrderClose, OrderDelete. La requête a quitté votre terminal, le serveur du courtier l’a examinée et l’a refusée. On y trouve par exemple 129 (ERR_INVALID_PRICE), 130 (ERR_INVALID_STOPS), 134 (ERR_NOT_ENOUGH_MONEY) ou 138 (ERR_REQUOTE). Certains sont passagers (le prix a bougé, le serveur est occupé), d’autres signalent un défaut de votre logique (stop trop proche, volume mal arrondi).
Les erreurs d’exécution (4000 et au-delà). Elles sont détectées par le terminal lui-même, avant tout dialogue avec le serveur ou en dehors du trading : paramètre de fonction invalide (4051), prix mal formé passé à une fonction de trading (4107), ticket inexistant (4108), trading automatique non autorisé (4109). Une erreur de cette famille ne se règle jamais en « réessayant » : il faut corriger le code ou la configuration.
À côté de ces deux familles, il existe les erreurs de compilation, que MetaEditor affiche avant même que le programme ne tourne. Elles ont leur propre page, car elles n’ont pas de code numérique à récupérer avec GetLastError().
Ordre de lecture conseillé
- Commencez par GetLastError en MQL4 : sans une méthode fiable pour lire le code au bon moment, toutes les autres pages sont inutiles.
- Lisez ensuite les erreurs liées au prix et aux niveaux : 129, 135, 136, 138, puis 130 et 145. Ce sont les plus fréquentes sur les comptes réels.
- Enchaînez avec les erreurs de volume et de capital : 131, 134 et 148.
- Terminez par les erreurs d’autorisation et de programmation : 133, 146, 4051, 4107, 4108, 4109, 4110 et 4111, puis les erreurs de compilation.
Si vous partez d’un message précis du journal, allez directement à la page du code concerné : chacune est autonome et renvoie vers ses voisines lorsque deux erreurs se ressemblent.
Les pages de la rubrique
Méthode
- GetLastError en MQL4 : lire le code au bon moment,
ResetLastError,_LastError,ErrorDescriptionet un modèle de journalisation réutilisable. - Erreurs de compilation MQL4 : comprendre les messages de MetaEditor, distinguer erreurs et avertissements, et les corriger sous
#property strict.
Prix et exécution
- Erreur 129 : prix invalide : le prix d’ouverture ou de clôture n’est pas celui que le serveur attend.
- Erreur 135 : prix modifié : le prix a changé entre la lecture et l’envoi ; comment réessayer sans boucle infinie.
- Erreur 136 : pas de prix : le courtier n’a pas de cotation à vous proposer.
- Erreur 138 : requote : le rôle du paramètre
slippageet la gestion des recotations.
Stops et modifications
- Erreur 130 : stops invalides : stop loss, take profit ou prix d’ordre en attente trop proches ou du mauvais côté.
- Erreur 145 : modification refusée (trop proche) : le niveau de gel (FreezeLevel) qui bloque trailing stops et break-even.
Volume, marge et limites
- Erreur 131 : volume invalide : arrondir un lot au pas, au minimum et au maximum du symbole.
- Erreur 134 : fonds insuffisants : vérifier la marge libre avant d’envoyer l’ordre.
- Erreur 148 : trop d’ordres : la limite d’ordres ouverts et en attente fixée par le courtier.
Autorisations et environnement
- Erreur 133 : trading interdit : le serveur refuse le trading sur ce symbole ou ce compte.
- Erreur 146 : contexte de trading occupé : plusieurs EA qui se disputent le fil de trading du terminal.
- Erreur 4109 : trading non autorisé : l’option « Allow live trading » et le bouton AutoTrading.
- Erreurs 4110 et 4111 : achats ou ventes non autorisés : le réglage des positions autorisées dans les propriétés de l’EA.
Erreurs de programmation
- Erreur 4051 : paramètre invalide : une fonction reçoit une valeur hors de son domaine.
- Erreur 4107 : prix invalide : le terminal rejette un prix mal formé avant même l’envoi.
- Erreur 4108 : ticket invalide : agir sur un ordre qui n’existe plus, ou qui n’a jamais existé.
Réessayer ou corriger : le tableau de décision
La première question à se poser face à un code est simple : la même requête peut-elle réussir quelques instants plus tard ? Le tableau ci-dessous résume l’approche que nous détaillons dans chaque page. Il s’agit d’une classification pratique : la documentation officielle donne les libellés, pas une politique de reprise.
| Code | Constante | Nature | Réaction conseillée |
|---|---|---|---|
| 129 | ERR_INVALID_PRICE | Prix d’exécution refusé | Rafraîchir les prix, normaliser, renvoyer une fois |
| 130 | ERR_INVALID_STOPS | Niveaux trop proches ou mal placés | Corriger le calcul, ne pas renvoyer tel quel |
| 131 | ERR_INVALID_TRADE_VOLUME | Volume non conforme | Corriger l’arrondi du lot |
| 133 | ERR_TRADE_DISABLED | Trading désactivé côté serveur | Arrêter, prévenir l’utilisateur |
| 134 | ERR_NOT_ENOUGH_MONEY | Marge insuffisante | Réduire le volume ou renoncer |
| 135 | ERR_PRICE_CHANGED | Prix modifié | Rafraîchir et renvoyer, nombre d’essais limité |
| 136 | ERR_OFF_QUOTES | Pas de cotation | Patienter, puis renvoyer |
| 138 | ERR_REQUOTE | Recotation | Rafraîchir et renvoyer, nombre d’essais limité |
| 145 | ERR_TRADE_MODIFY_DENIED | Ordre trop proche du marché | Attendre que le prix s’éloigne |
| 146 | ERR_TRADE_CONTEXT_BUSY | Fil de trading occupé | Attendre qu’il se libère |
| 148 | ERR_TRADE_TOO_MANY_ORDERS | Limite du courtier atteinte | Ne plus ouvrir, revoir la logique |
| 4051 | ERR_INVALID_FUNCTION_PARAMVALUE | Paramètre hors domaine | Corriger le code |
| 4107 | ERR_INVALID_PRICE_PARAM | Prix mal formé | Normaliser le prix |
| 4108 | ERR_INVALID_TICKET | Ticket inexistant | Resélectionner l’ordre |
| 4109 | ERR_TRADE_NOT_ALLOWED | Trading non autorisé pour l’EA | Corriger la configuration |
| 4110 / 4111 | ERR_LONGS_NOT_ALLOWED / ERR_SHORTS_NOT_ALLOWED | Sens interdit par les réglages | Respecter le réglage |
La règle d’or : un nombre de tentatives borné, un RefreshRates() avant chaque nouvel essai et un message clair dans le journal. Un EA qui renvoie le même ordre en boucle sur une erreur 130 ou 134 n’obtiendra jamais un autre résultat, et certains courtiers surveillent les requêtes trop fréquentes (codes 8 et 141).
Où ces erreurs apparaissent-elles ?
La quasi-totalité des codes de trading sont produits par les fonctions de la rubrique Ordres et positions en MQL4. Avant de traiter une erreur, vérifiez donc que l’appel lui-même est correctement construit : les pages OrderSend en MQL4 et StopLevel et FreezeLevel couvrent les paramètres et les contraintes du serveur. Une bonne partie des erreurs 129, 130 et 4107 disparaît dès que les prix sont normalisés et que les distances minimales sont respectées.
Gardez aussi en tête que le testeur de stratégie ne reproduit pas tous les refus d’un serveur réel. Les recotations, les contextes occupés ou les absences de prix sont rares, voire absents, en backtest. Un EA qui n’a jamais rencontré d’erreur 138 dans le testeur doit malgré tout savoir la traiter avant d’être placé sur un compte réel.
Si vous préparez une migration vers MetaTrader 5
MQL5 n’utilise pas la même numérotation : les refus du serveur y prennent la forme de codes de retour 10004, 10016 ou 10019, lus dans la structure de résultat plutôt qu’avec GetLastError(). Si vous portez un EA, la rubrique Migrer de MQL4 vers MQL5 explique comment adapter votre gestion d’erreurs au nouveau modèle.
Questions fréquentes
Comment connaître la signification d’un code d’erreur MQL4 ?
Appelez GetLastError() juste après l’échec de la fonction, puis cherchez le numéro dans cette rubrique ou dans la documentation officielle. La fonction ErrorDescription() de la bibliothèque stdlib.mqh renvoie aussi un libellé en anglais, pratique pour le journal.
Quelle différence entre l’erreur 129 et l’erreur 4107 ?
La 129 est renvoyée par le serveur de trading : la requête est partie mais le prix a été refusé. La 4107 est une erreur d’exécution du terminal : le prix passé à la fonction est jugé invalide avant tout envoi, le plus souvent parce qu’il n’est pas normalisé.
Faut-il toujours réessayer après une erreur de trading ?
Non. Les erreurs passagères (135, 136, 138, 146) justifient quelques nouvelles tentatives après rafraîchissement des prix. Les erreurs de logique ou de configuration (130, 131, 134, 4051, 4109) se reproduiront à l’identique : il faut corriger le calcul ou les réglages.
Les codes d’erreur MQL4 sont-ils les mêmes en MQL5 ?
Non. Les erreurs d’exécution et les codes de retour du serveur ont été renumérotés en MQL5. Les causes restent souvent proches, mais il faut adapter le code de traitement lors d’une migration.
- GetLastError en MQL4
- Erreur 129 : prix invalide
- Erreur 130 : stops invalides
- Erreur 131 : volume invalide
- 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
