Erreurs MetaTrader courantes : codes MT4 et MT5, causes et corrections côté serveur

Comment MetaTrader signale les erreurs

MetaTrader signale les erreurs sous forme de codes numérotés portant des noms fixes documentés par MetaQuotes, et le numéro indique à quel endroit de la chaîne la requête a échoué. MT4 et MT5 utilisent des numérotations différentes : un même problème a donc deux codes distincts selon la plateforme.

Dans MetaTrader 5, chaque requête de trading reçoit une réponse du serveur de trading. MetaQuotes décrit le mécanisme ainsi :

"All requests to execute trade operations are sent as a structure of a trade request MqlTradeRequest using function OrderSend(). The function execution result is placed to structure MqlTradeResult, whose retcode field contains the trade server return code."
(Traduction : « Toutes les requêtes d'exécution d'opérations de trading sont envoyées sous forme d'une structure de requête de trading MqlTradeRequest à l'aide de la fonction OrderSend(). Le résultat de l'exécution de la fonction est placé dans la structure MqlTradeResult, dont le champ retcode contient le code de retour du serveur de trading. »)— MQL5 Reference, Trade Server Return Codes, MetaQuotes (consulté en octobre 2026)

Les codes de retour du serveur de trading MT5 vont de 10004 (TRADE_RETCODE_REQUOTE) à 10046 (TRADE_RETCODE_HEDGE_PROHIBITED). Dans MetaTrader 4, le même type d'information provient de GetLastError(). Les codes liés au trading se situent dans la plage basse (0–150, par exemple 130 ERR_INVALID_STOPS). Les erreurs d'exécution des programmes commencent à 4000 (par exemple 4109 ERR_TRADE_NOT_ALLOWED).

Un code de succès ne signifie pas qu'un ordre a été exécuté. La référence MQL5 de OrderSend() avertit qu'« un résultat positif de la fonction OrderSend() ne signifie pas que l'ordre a été exécuté ». Cela signifie seulement que la requête a été acceptée pour traitement ultérieur. Lorsqu'un client dit « c'était OK mais rien ne s'est passé », consultez le journal du serveur.

Il existe trois endroits où trouver le code réel :

• Onglet Journal (événements de la plateforme : connexion, authentification, requêtes d'ordres).
• Onglet Experts (messages affichés par les Expert Advisors et les scripts, y compris les résultats de GetLastError()).
• Fichiers journaux sur le disque. L'aide MT5 de MetaQuotes indique : « Les fichiers journaux de la plateforme sont stockés dans le répertoire Logs, et les fichiers journaux des Experts sont enregistrés dans MQL5\Logs. Les noms de fichiers correspondent à la date de génération du journal — YYYYMMDD.LOG. »

La visionneuse de journaux intégrée permet de filtrer les entrées par « Full, No connection, Errors only ».

Erreurs de connexion : « No connection » et « Invalid account »

« No connection » signifie que le terminal ne parvient pas à joindre l'adresse du serveur de trading qui lui a été fournie, et « Invalid account » signifie qu'il a joint un serveur qui a refusé l'identifiant. Chacune exige des vérifications différentes, et le courtier voit des éléments que le trader ne voit pas.

Ce que le trader peut vérifier

1. Vérifier dans un navigateur que la connexion internet fonctionne.
2. Ressaisir l'identifiant, le mot de passe et le nom exact du serveur. L'aide MT5 précise que l'on peut aussi saisir l'adresse manuellement sous la forme « [numéro de serveur]:[numéro de port], par exemple 192.168.0.1:443 ».
3. Vérifier qu'il s'agit du mot de passe principal. MetaQuotes explique que « l'autorisation investisseur permet de voir l'état du compte, d'analyser les prix et de travailler avec vos propres Expert Advisors, mais pas de trader ».
4. Vérifier le proxy et le pare-feu. Dans MT5, l'onglet Serveur du menu Outils > Options contient le « paramétrage de la connexion au serveur, configuration d'un serveur proxy ».
5. Ouvrir la visionneuse de journaux, filtrer sur « No connection » et envoyer le fichier YYYYMMDD.LOG au courtier.

Ce que le courtier doit vérifier côté serveur

• Accessibilité de chaque point d'accès. Testez chaque adresse et chaque port publiés dans la liste des serveurs depuis l'extérieur de votre propre réseau, et testez depuis plusieurs régions.
• Modifications récentes de l'infrastructure. De nouvelles IP, des enregistrements DNS, des déménagements de data center ou des règles de protection DDoS provoquent souvent des vagues de « No connection ».
• Santé du serveur. CPU, mémoire et disque sur les serveurs de trading et d'accès. Une surcharge se manifeste par des délais d'attente dépassés (128 ERR_TRADE_TIMEOUT, 10012 TRADE_RETCODE_TIMEOUT) avant les déconnexions complètes.
• État du compte. Le compte est-il activé ? Est-il dans le bon groupe ? A-t-il été déplacé lors d'une migration ? Un changement de mot de passe obligatoire a-t-il été activé ? L'aide MT5 confirme que « le changement de mot de passe obligatoire peut être activé par l'administrateur du serveur de trading ».
• Anciennes versions du client. 5 ERR_OLD_VERSION (« Old version of the client terminal ») signifie que le terminal doit être mis à jour.

Pour les problèmes plus profonds de réseau et d'hôte, consultez dépannage des serveurs forex et hébergement de serveurs MetaTrader.

Codes d'erreur MT4 et leurs équivalents MT5

Les erreurs de trading MT4 utilisent de petits numéros que MetaQuotes répertorie dans la MQL4 Reference, et la plupart ont un équivalent direct dans MT5. Utilisez la correspondance ci-dessous lorsque des clients passent d'une plateforme à l'autre ou lorsque vous exploitez les deux serveurs pendant une migration MT4 vers MT5.

Cette correspondance est notre guide pratique, et non un tableau officiel de MetaQuotes. Les descriptions elles-mêmes sont tirées de la page MQL4 Trade Server Return Codes.

Trade context busy (146) est propre à MT4. La fonction MQL4 IsTradeContextBusy() « renvoie true si un thread de trading est occupé par un autre Expert Advisor ». Il s'agit d'un problème côté client : plusieurs EA d'un même terminal se disputent le thread de trading, et la solution consiste à ajouter une logique de nouvelle tentative ou à réduire le nombre d'EA par terminal. Le courtier ne peut pas le corriger sur le serveur.

Erreurs de trading automatique et d'autorisations

Les erreurs de trading automatique se distinguent nettement par leur nom : 10026 indique que le serveur l'a désactivé, et 10027 que c'est le terminal client. Dans MT4, l'équivalent côté client est l'erreur d'exécution 4109.

Les plugins peuvent aussi bloquer ou réécrire des requêtes. Un plugin de risque ou de routage qui rejette des ordres apparaît pour le client comme un rejet générique (10006) ou une erreur générale (2). Si les rejets ont commencé après la mise à jour d'un plugin, vérifiez d'abord ce plugin. Nous les développons et les maintenons dans le cadre du développement de plugins MetaTrader.

De la gestion des urgences à la supervision

La plupart des erreurs MetaTrader récurrentes peuvent être détectées dans les journaux du serveur avant que les clients ne se plaignent. On y parvient en suivant les taux d'erreur plutôt que les tickets isolés. Une hausse des 10021 sur un symbole, des délais dépassés pendant une session ou des rejets après un redémarrage du bridge sont tous visibles dans les journaux quelques minutes après leur apparition.

FXSUPPORT assure le support des plateformes MT4/MT5 pour les courtiers et les prop firms : installation, mises à jour, sauvegardes, configuration, surveillance des journaux et configuration des bridges. Nous prenons également en charge l'infrastructure serveur au Royaume-Uni et aux Pays-Bas, avec supervision et un objectif de disponibilité de 99,9 %. Concrètement, nous :

• surveillons les journaux de la plateforme et du bridge pour détecter des schémas d'erreurs, et pas seulement les pannes ;
• revoyons les paramètres des symboles, des sessions et des groupes après chaque modification et avant les changements d'heure ;
• vérifions le comportement des plugins après les mises à jour de la plateforme ;
• protégeons les serveurs contre les attaques DDoS et veillons à ce que les sauvegardes restent restaurables.

Si vous dirigez un courtier et que votre équipe support passe ses journées à répondre aux mêmes tickets d'erreur, c'est le signe que la cause se trouve sur le serveur. Consultez support MT5 et support MT4 pour connaître notre périmètre, ou contactez-nous pour un audit technique gratuit.