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

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é.

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

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.

FamilleOù la lirePlageExemple
Codes de retour du serveurresult.retcode après OrderSend() ou OrderCheck()10004 à 1004610016 TRADE_RETCODE_INVALID_STOPS
Erreurs d’exécutionGetLastError() ou _LastError0, 4001 et suivants4756 ERR_TRADE_SEND_FAILED
Erreurs critiquesOnglet Experts du terminal, le programme s’arrêtepas de code exploitablearray out of range
Erreurs de compilationOnglet Erreurs de MetaEditormessages du compilateurundeclared 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 :

  1. GetLastError et gestion des erreurs : le mécanisme de base, ResetLastError(), _LastError et la bonne manière de journaliser.
  2. 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.
  3. 4756 Échec d’envoi de la requête : le pont entre les deux familles.
  4. Les pages consacrées à chaque retcode, en commençant par les plus fréquents en production : 10016, 10014, 10030, 10019 et 10027.
  5. 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

Les codes de retour du serveur

Les erreurs d’exécution et critiques

Avant même l’exécution

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.

  1. 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é.
  2. 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.
  3. 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.
  4. 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 codeExemplesRéaction raisonnable
Erreur de paramètre10013, 10014, 10015, 10016, 10030Corriger le code, ne pas réessayer tel quel
Interdiction10017, 10026, 10027Alerter, suspendre les envois
Condition de marché passagère10004, 10020, 10021Rafraîchir le prix, un ou deux essais espacés
Condition de compte10019Réduire le volume ou renoncer
Surcharge10024Ralentir, regrouper les modifications
Un code de retour correct ne garantit rien sur le résultat financier d’une stratégie. Le trading avec effet de levier comporte un risque élevé de perte en capital : testez toute gestion d’erreur sur compte démo avant de l’utiliser en réel, et consultez notre page sur la gestion du risque.

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.

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.