Nouveau : la formation trading algorithmique MQL5, MQL4 et ProRealTimeDécouvrir →

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.

Mis à jour le 23 octobre 2026Lecture : 9 minPar Alix, OptiBot Trading

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é

  1. Commencez par GetLastError en MQL4 : sans une méthode fiable pour lire le code au bon moment, toutes les autres pages sont inutiles.
  2. 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.
  3. Enchaînez avec les erreurs de volume et de capital : 131, 134 et 148.
  4. 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, ErrorDescription et 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

Stops et modifications

Volume, marge et limites

Autorisations et environnement

Erreurs de programmation

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.

CodeConstanteNatureRéaction conseillée
129ERR_INVALID_PRICEPrix d’exécution refuséRafraîchir les prix, normaliser, renvoyer une fois
130ERR_INVALID_STOPSNiveaux trop proches ou mal placésCorriger le calcul, ne pas renvoyer tel quel
131ERR_INVALID_TRADE_VOLUMEVolume non conformeCorriger l’arrondi du lot
133ERR_TRADE_DISABLEDTrading désactivé côté serveurArrêter, prévenir l’utilisateur
134ERR_NOT_ENOUGH_MONEYMarge insuffisanteRéduire le volume ou renoncer
135ERR_PRICE_CHANGEDPrix modifiéRafraîchir et renvoyer, nombre d’essais limité
136ERR_OFF_QUOTESPas de cotationPatienter, puis renvoyer
138ERR_REQUOTERecotationRafraîchir et renvoyer, nombre d’essais limité
145ERR_TRADE_MODIFY_DENIEDOrdre trop proche du marchéAttendre que le prix s’éloigne
146ERR_TRADE_CONTEXT_BUSYFil de trading occupéAttendre qu’il se libère
148ERR_TRADE_TOO_MANY_ORDERSLimite du courtier atteinteNe plus ouvrir, revoir la logique
4051ERR_INVALID_FUNCTION_PARAMVALUEParamètre hors domaineCorriger le code
4107ERR_INVALID_PRICE_PARAMPrix mal forméNormaliser le prix
4108ERR_INVALID_TICKETTicket inexistantResélectionner l’ordre
4109ERR_TRADE_NOT_ALLOWEDTrading non autorisé pour l’EACorriger la configuration
4110 / 4111ERR_LONGS_NOT_ALLOWED / ERR_SHORTS_NOT_ALLOWEDSens interdit par les réglagesRespecter 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.

Un EA qui gère mal ses erreurs peut multiplier les requêtes, ouvrir des positions non prévues ou laisser une position sans stop. Testez systématiquement la gestion d’erreurs sur un compte de démonstration avant toute utilisation en réel : le trading sur marge comporte un risque de perte supérieur au capital investi.

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.

A

Alix · fondateur d’OptiBot Trading

Développeur MQL5 et ProBuilder, spécialiste du backtest et de l’optimisation de stratégies automatiques. Chaque contenu est vérifié sur la documentation officielle (MQL5.com, manuels ProRealTime) et testé avant publication. Notre méthode éditoriale.