MQL5 · Codes d’erreur
Codes d’erreur et de retour MQL5 : diagnostiquer et corriger un EA
Retcodes du serveur, GetLastError, erreurs critiques et de compilation : comprendre chaque famille de codes MQL5 et savoir lequel lire pour expliquer un ordre refusé.
Quand un Expert Advisor n’ouvre pas la position attendue, la réponse se trouve presque toujours dans un code numérique. MQL5 en produit de trois familles bien distinctes : les codes de retour du serveur de trading (10004 à 10046, renvoyés dans le champ retcode de MqlTradeResult), les erreurs d’exécution lues avec GetLastError() (0, puis 4001 et au-delà, comme 4756), et les erreurs critiques qui arrêtent net le programme (dépassement de tableau, division par zéro, pointeur invalide). Il faut ajouter à cela les erreurs de compilation affichées par MetaEditor, qui empêchent tout simplement le fichier .ex5 d’être produit.
Cette rubrique explique chacune de ces familles, puis détaille un par un les codes que l’on rencontre réellement en trading automatisé : ce qu’ils signifient selon la documentation officielle, pourquoi ils apparaissent, comment les reconnaître dans le journal et quel code écrire pour les éviter ou les traiter proprement.
Trois familles de codes à ne pas confondre
La confusion la plus fréquente consiste à mélanger le code renvoyé par le serveur et celui renvoyé par le terminal. Ils ne vivent pas au même endroit et ne se lisent pas de la même façon.
| Famille | Où la lire | Plage | Exemple |
|---|---|---|---|
| Codes de retour du serveur | result.retcode après OrderSend() ou OrderCheck() | 10004 à 10046 | 10016 TRADE_RETCODE_INVALID_STOPS |
| Erreurs d’exécution | GetLastError() ou _LastError | 0, 4001 et suivants | 4756 ERR_TRADE_SEND_FAILED |
| Erreurs critiques | Onglet Experts du terminal, le programme s’arrête | pas de code exploitable | array out of range |
| Erreurs de compilation | Onglet Erreurs de MetaEditor | messages du compilateur | undeclared identifier |
Un même incident produit souvent deux codes. Si OrderSend() renvoie false parce que le volume est mal arrondi, GetLastError() indique généralement 4756 (l’envoi a échoué) tandis que result.retcode contient 10014 (volume invalide). Le premier dit « ça n’est pas passé », le second dit « pourquoi ». C’est la raison pour laquelle un journal de robot sérieux affiche toujours les deux.
Ordre de lecture conseillé
Si vous découvrez le sujet, suivez cet ordre plutôt que l’ordre numérique :
- GetLastError et gestion des erreurs : le mécanisme de base,
ResetLastError(),_LastErroret la bonne manière de journaliser. - Codes de retour du serveur de trading : la table complète des retcodes et la différence entre succès (10008, 10009, 10010) et échec.
- 4756 Échec d’envoi de la requête : le pont entre les deux familles.
- Les pages consacrées à chaque retcode, en commençant par les plus fréquents en production : 10016, 10014, 10030, 10019 et 10027.
- Les erreurs critiques, puis les erreurs de compilation, qui relèvent davantage de la qualité du code que du dialogue avec le courtier.
Les pages de la rubrique
Comprendre le mécanisme
- GetLastError et gestion des erreurs : lire, réinitialiser et tracer le dernier code d’erreur d’exécution sans se laisser piéger par une valeur ancienne.
- Codes de retour du serveur de trading : la structure
MqlTradeResult, la table des codes 100xx et une fonction de diagnostic réutilisable.
Les codes de retour du serveur
- 10004 Requote : le prix demandé n’est plus disponible en exécution instantanée ou à la demande.
- 10006 Requête rejetée : refus côté serveur, souvent sans motif détaillé.
- 10013 Requête invalide : la structure
MqlTradeRequestest incohérente. - 10014 Volume invalide : lot hors bornes ou mal aligné sur le pas.
- 10015 Prix invalide : prix non normalisé ou du mauvais côté du marché.
- 10016 Stops invalides : stop loss ou take profit trop proches ou inversés.
- 10017 Trading désactivé : le symbole ou le compte n’autorise pas l’opération.
- 10018 Marché fermé : envoi en dehors des sessions de trading.
- 10019 Fonds insuffisants : la marge libre ne couvre pas l’ordre.
- 10021 Pas de cotations : le serveur n’a pas de prix pour traiter la requête.
- 10024 Trop de requêtes : l’EA inonde le serveur.
- 10027 Trading automatique désactivé : le bouton Algo Trading du terminal est coupé.
- 10030 Mode de remplissage non supporté : la politique FOK, IOC ou Return ne correspond pas au symbole.
Les erreurs d’exécution et critiques
- 4756 Échec d’envoi de la requête : ce que signifie
ERR_TRADE_SEND_FAILEDet où trouver la vraie cause. - Array out of range : accès à un indice inexistant, arrêt immédiat du programme.
- Division par zéro : le calcul de lot ou de ratio qui fait tomber l’EA.
- Pointeur invalide : objet supprimé ou jamais créé.
Avant même l’exécution
- Erreurs de compilation fréquentes : lire les messages de MetaEditor et corriger les plus courants.
Une méthode de diagnostic en quatre questions
Face à un ordre qui ne passe pas, posez-vous ces questions dans l’ordre. Elles éliminent la grande majorité des cas sans chercher au hasard.
- Le programme tourne-t-il encore ? Si l’onglet Experts affiche une erreur critique, l’EA est arrêté : aucun code de trading ne sera produit tant que le bug n’est pas corrigé.
- Le trading est-il autorisé ? Bouton Algo Trading, case « Autoriser le trading algorithmique » dans les propriétés de l’EA, droits du compte : c’est le terrain des codes 10017, 10026 et 10027.
- La requête est-elle conforme au symbole ? Volume, prix, distances des stops, mode de remplissage : ce sont les codes 10014, 10015, 10016 et 10030. Ils se préviennent presque tous par une lecture des propriétés avec SymbolInfoDouble et SymbolInfoInteger.
- Le marché et le compte le permettent-ils à cet instant ? Marché fermé (10018), pas de prix (10021), marge insuffisante (10019), requote (10004) : des conditions qui changent dans le temps et justifient parfois un nouvel essai.
L’outil qui répond à la plupart de ces questions avant tout envoi est OrderCheck : il remplit une structure MqlTradeCheckResult avec un retcode, la marge requise et la marge libre restante, sans rien envoyer au serveur.
Réessayer ou abandonner ?
Tous les codes n’appellent pas la même réaction. Réessayer aveuglément un ordre refusé pour volume invalide ne servira à rien et peut provoquer un 10024 (requêtes trop fréquentes). À l’inverse, abandonner sur un requote fait parfois manquer une entrée légitime.
| Type de code | Exemples | Réaction raisonnable |
|---|---|---|
| Erreur de paramètre | 10013, 10014, 10015, 10016, 10030 | Corriger le code, ne pas réessayer tel quel |
| Interdiction | 10017, 10026, 10027 | Alerter, suspendre les envois |
| Condition de marché passagère | 10004, 10020, 10021 | Rafraîchir le prix, un ou deux essais espacés |
| Condition de compte | 10019 | Réduire le volume ou renoncer |
| Surcharge | 10024 | Ralentir, regrouper les modifications |
Questions fréquentes
Quelle différence entre GetLastError et result.retcode ?
GetLastError() renvoie le dernier code d’erreur d’exécution du terminal (0, 4xxx, 5xxx…). result.retcode contient la réponse du serveur de trading (100xx) après OrderSend() ou OrderCheck(). Lors d’un échec d’envoi, il faut lire les deux pour connaître la cause.
Le code 10009 est-il une erreur ?
Non. 10009 (TRADE_RETCODE_DONE) signifie que la requête a été exécutée. 10008 (TRADE_RETCODE_PLACED) indique un ordre placé et 10010 une exécution partielle. Ce sont les codes de succès à tester avant de conclure à un échec.
Peut-on intercepter une erreur critique comme array out of range ?
Non. La documentation indique que ces erreurs terminent immédiatement le programme. Il n’existe pas de bloc try/catch en MQL5 : la seule parade est de vérifier tailles, diviseurs et pointeurs avant de les utiliser.
Pourquoi mon EA fonctionne dans le testeur mais pas en réel ?
Le testeur simule un serveur idéal : pas de requote, modes de remplissage tolérants, pas de déconnexion. En réel, les propriétés du symbole chez votre courtier (StopsLevel, filling, pas de volume) s’appliquent strictement. Lisez-les dans le code au lieu de les supposer.
- 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é
- 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
