La MetaTrader 5 Web API est l’interface côté serveur de MetaQuotes qui relie un serveur de trading MT5 à des sites web, des CRM et d’autres systèmes de l’entreprise. Une application s’y connecte avec un compte manager et peut gérer utilisateurs, soldes, groupes, symboles, ordres, positions, transactions, ticks et graphiques. Elle ne connecte pas de fournisseurs de liquidité et ne diffuse pas le carnet d’ordres d’un LP : ces tâches relèvent d’autres API MT5.
Qu’est-ce que la MetaTrader 5 Web API ?
La MetaTrader 5 Web API est l’interface fournie par MetaQuotes pour relier un serveur de trading MT5 aux services web du courtier : espace client, CRM, traitement des paiements, reporting et interfaces de trading sur mesure. Elle s’adresse au serveur, pas au terminal d’un trader, et s’authentifie en tant que manager, c’est-à-dire avec le même type de compte que celui de vos équipes de back-office dans le terminal MT5 Manager.
La définition qu’en donne MetaQuotes tient en une ligne, et elle est juste : la Web API sert à l’intégration avec des ressources web et d’autres services de l’entreprise. Tout le reste de cette page porte sur ce que cela implique en pratique. La documentation technique complète se trouve sur le site d’assistance de MetaQuotes, accessible aux titulaires de licence après connexion ; si vous détenez une licence serveur MT5, ou travaillez pour un titulaire, cette documentation prime sur tout ce qui est écrit ici.
“La Web API est utilisée pour l’intégration de la plateforme avec les ressources web et les autres services de l’entreprise.”
En quoi la Web API diffère-t-elle des autres API MetaTrader 5 ?
MetaQuotes publie cinq API pour MT5, chacune avec un rôle distinct. La Web API est celle qui dialogue avec le serveur depuis l’extérieur, par le réseau ; les autres s’exécutent dans le serveur, le relient aux marchés ou enrichissent ses rapports. Les définitions de la deuxième colonne sont traduites de la page de MetaQuotes destinée aux courtiers.
| API | Définition de MetaQuotes | Où s’exécute votre code | Usage type chez un courtier |
|---|---|---|---|
| Web API | « utilisée pour l’intégration de la plateforme avec les ressources web et les autres services de l’entreprise » | Sur votre propre serveur, connecté par le réseau | CRM, espace client, paiements, WebTrader sur mesure |
| Manager API | « permet de développer des utilitaires d’administration et de gestion personnalisés, voire votre propre terminal manager » | Dans une application manager connectée au serveur | Outils de back-office, utilitaires de dealing et de gestion des risques |
| Server API | « peut vous aider à ajouter des fonctions au MetaTrader 5 Trade Server et au MetaTrader 5 History Server » | Dans le serveur MT5, sous forme de plugin | Règles personnalisées sur chaque transaction, bonus, logique de copie |
| Gateway API | « utilisée pour l’intégration de MetaTrader 5 avec d’autres systèmes de trading et la création de flux de données personnalisés » | Dans une passerelle (gateway) rattachée à la plateforme | Fournisseurs de liquidité, bourses, flux de données |
| Report API | « étend les rapports produits par les serveurs de trading MetaTrader 5 » | Dans le composant de reporting | Rapports réglementaires et de gestion personnalisés |
La MT5 Web API est-elle REST ou WebSocket ?
La MT5 Web API fonctionne en requête-réponse : votre application envoie une commande et attend la réponse. Dans les versions actuelles, cela passe par des requêtes HTTPS vers des chemins comme /api/user/get ou /api/tick/last, avec des réponses JSON, à côté d’un protocole binaire plus ancien sur socket persistant, qu’utilise le code d’exemple de MetaQuotes. Nous employons les deux, pour des tâches différentes.
Ce n’est en revanche pas une API WebSocket. Rien dans la Web API ne vous pousse spontanément un prix ou une modification de position ; si vous voulez des mises à jour en direct, vous les demandez à la fréquence de votre choix. Quand un fournisseur affirme que sa « MT5 Web API est basée sur WebSocket », il veut généralement dire qu’il a construit une couche WebSocket par-dessus, ce que nous avons précisément fait pour notre WebTrader à votre marque.
Une deuxième confusion mérite d’être levée d’emblée. Plusieurs services vendent une « MT5 API » qui se connecte au compte d’un trader via un terminal hébergé dans leur cloud, ou via le package Python de MetaQuotes pour le terminal de bureau. Ce sont des outils au niveau du compte, destinés aux traders et aux services de signaux. La Web API se situe au niveau du courtier : elle voit tous les comptes du serveur que le manager est autorisé à voir.
Que peut-on construire avec la MetaTrader 5 Web API ?
Presque tous les systèmes orientés client dont un courtier a besoin peuvent reposer sur la Web API, car elle donne accès aux objets qui comptent pour ces systèmes : utilisateurs, comptes, groupes, symboles, ordres, positions, transactions et historique des prix. Le tableau associe les domaines de commandes que nous utilisons aux usages qu’ils servent.
| Domaine | Ce qu’il couvre | Usage type |
|---|---|---|
| Utilisateurs et comptes | Créer, modifier, supprimer et lire des comptes ; vérifier ou changer des mots de passe ; lire solde, fonds propres (equity) et marge | Ouverture de compte après le KYC dans le CRM, réinitialisation de mot de passe, tableaux de bord de l’espace client |
| Opérations sur le solde | Dépôts, retraits, crédit et corrections sur un compte | Créditer automatiquement un dépôt par carte ou virement |
| Groupes et symboles | Lire et gérer les paramètres des groupes et des symboles | Afficher dans une interface les bonnes spécifications de contrat, marges et sessions |
| Ordres, positions, transactions, historique | Données de trading ouvertes et historiques, y compris des requêtes groupées sur de nombreux comptes | Historique des transactions, relevés, calcul des commissions des apporteurs d’affaires (IB) |
| Prix et graphiques | Derniers ticks, statistiques de ticks, historique des ticks et barres de graphique | Cotations et graphiques dans un WebTrader ou une application mobile |
| Demandes de trading | Demandes exécutées sur le serveur pour le compte d’un client, avec un code de résultat | Passer, modifier et clôturer des ordres depuis une interface sur mesure |
| Messagerie et actualités | Messagerie interne et actualités vers les terminaux | Messages de service aux clients |
Que ne peut pas faire la MT5 Web API ?
La Web API ne peut pas connecter votre serveur à la liquidité, ne peut pas exécuter de code dans le serveur et ne peut pas vous pousser de données. Ces limites sont voulues : d’autres API MetaTrader 5 existent pour chacune de ces tâches.
- Pas de connexion à la liquidité. Les prix des banques ou des fournisseurs prime-of-prime arrivent par une passerelle (gateway), un bridge de liquidité ou Ultency : voir les pages MT5 Gateway API et intégration de la liquidité.
- Pas de carnet d’ordres LP ni de profondeur de marché. La Web API fournit les derniers ticks et des statistiques par symbole. Elle ne diffuse pas le carnet agrégé de vos fournisseurs ; une interface basée sur la Web API affiche donc le bid et l’ask, pas une échelle de profondeur de marché.
- Pas de logique dans le serveur. Les règles qui doivent s’appliquer à chaque transaction, avant son exécution, nécessitent un plugin Server API. Une application Web API ne voit que ce qui s’est déjà produit.
- Pas de push. Chaque mise à jour est une requête ; des cotations et des positions en direct supposent une interrogation périodique (polling) à un rythme que vous choisissez et que le serveur peut absorber.
- Pas de rapports serveur personnalisés. Étendre les rapports produits par le serveur de trading lui-même relève de la Report API.
Comment FXUP utilise-t-elle la MT5 Web API pour son WebTrader ?
Notre WebTrader et nos applications mobiles ne dialoguent jamais directement avec MT5. Ils se connectent en WebSocket sécurisé à un back-end écrit en Go, et c’est ce back-end qui dialogue avec le serveur MT5 via la Web API, en utilisant à la fois le protocole binaire et les requêtes HTTPS. Le client reçoit des mises à jour en mode push ; le serveur MT5 ne voit qu’un nombre restreint et prévisible de sessions manager.
Vous pouvez tester le résultat dans la démo du WebTrader et la démo de l’application mobile, toutes deux connectées à un véritable environnement de démonstration MT5. FXUP développe en toute indépendance et n’est pas affiliée à MetaQuotes ; nous travaillons sur les interfaces publiées comme n’importe quel autre intégrateur. Notre propre CRM utilise le même back-end, et nous travaillons aussi avec des CRM partenaires, en proposant celui qui convient à l’organisation du courtier.
Interrogation groupée
Une seule boucle demande à MT5 les ticks, positions, ordres et chiffres des comptes toutes les 100 millisecondes au moyen de requêtes groupées, si bien que la charge sur le serveur n’augmente pas avec le nombre d’utilisateurs connectés.
Push par client
Chaque client connecté ne reçoit que les symboles et les comptes auxquels il s’est abonné, et les sections inchangées ne sont pas renvoyées. Les trames volumineuses sont compressées.
Cache d’historique
L’historique des graphiques est mis en cache sur disque et chargé à la demande ; un trader qui remonte des années de bougies H1 ne sollicite donc pas le serveur MT5 à chaque fois.
Sécurité des transactions
Un ordre identique encore en cours d’exécution est dédoublonné, et ni le serveur ni les applications ne renvoient automatiquement une transaction après un délai d’attente dépassé : une double exécution est pire qu’une nouvelle tentative décidée par le trader.
Comment les ordres sont-ils passés via la Web API ?
Un ordre passé via la Web API est une demande exécutée sur le serveur pour le compte du client, suivie d’un résultat. Votre application soumet la demande, reçoit un identifiant, puis lit l’issue : un code de retour comme 10009 (exécuté) ou 10008 (ordre placé), ou un rejet, par exemple stops invalides, marché fermé ou fonds insuffisants.
Deux conséquences pratiques en découlent. D’abord, les droits propres au client continuent de s’appliquer : paramètres de groupe, modes de trading des symboles, niveaux de stop et marge sont appliqués par le serveur, pas par votre interface ; c’est donc le serveur qui a le dernier mot. Ensuite, un délai d’attente dépassé ne signifie pas que l’ordre a échoué. Si la réponse n’arrive pas, la seule attitude honnête consiste à vérifier les positions et l’historique avant toute autre action. Nos interfaces indiquent au trader que l’issue est incertaine plutôt que de renvoyer le même ordre.
Les horodatages sont un autre détail qui piège les équipes. MT5 enregistre les heures dans le fuseau horaire configuré sur le serveur de trading ; tout ce que vous affichez aux clients ou stockez dans un CRM doit être converti en véritable UTC une seule fois, à un seul endroit.
Une intégration MT5 Web API est-elle sécurisée ?
La Web API elle-même utilise une authentification défi-réponse et prend en charge les sessions chiffrées ; l’essentiel du risque restant tient à la manière dont l’intégrateur gère le compte manager. Un manager Web API peut souvent déplacer des fonds et modifier des comptes : traitez ses identifiants comme les clés d’un compte bancaire. MetaQuotes indique sur sa page destinée aux courtiers que les échanges de données entre les composants du système passent par une connexion chiffrée ; vos propres systèmes doivent observer la même rigueur.
- Attribuez à l’intégration son propre compte manager, avec uniquement les droits et les groupes nécessaires ; ne réutilisez jamais l’identifiant d’un dealer.
- Limitez les adresses depuis lesquelles ce manager peut se connecter et conservez les identifiants dans un coffre-fort de secrets, pas dans le code source.
- N’exposez jamais la Web API aux navigateurs ni aux applications. Les clients se connectent à votre back-end, qui contrôle chaque requête au regard du compte du client.
- De votre côté, limitez le débit et bloquez les tentatives de connexion répétées en échec, par adresse IP.
- Journalisez chaque opération sur le solde, avec qui l’a déclenchée et pourquoi, et rapprochez chaque jour ces journaux du CRM.
La MT5 Web API a-t-elle des limites de requêtes ?
MetaQuotes ne publie pas de limites de requêtes sur ses pages publiques, et nous ne citerons pas de chiffres que nous ne pouvons pas sourcer. En pratique, la limite est la capacité de votre serveur et le comportement de votre intégration, et une intégration mal conçue peut ralentir un serveur de trading pour tout le monde.
Ce qui fonctionne chez nous : maintenir un pool de sessions authentifiées, séparer les demandes de trading des requêtes générales, utiliser les commandes groupées partout où elles existent, et mettre en cache tout ce qui ne change pas à chaque seconde, comme les paramètres des symboles et l’historique clôturé. Côté client, nous appliquons une protection générale sur les messages pour chaque connexion, mais aucune limite sur les ordres : un client a le droit d’envoyer des ordres à la suite, car c’est le principe même du trading.
Si vous concevez votre propre intégration, consignez son profil de charge avant la mise en production : à quelle fréquence vous interrogez chaque type de données, pour combien de comptes et via combien de sessions. Cette seule page répond à la plupart des questions que posera un administrateur de serveur.
Qui peut obtenir un accès à la MT5 Web API ?
L’accès à la Web API dépend de celui qui contrôle le serveur MT5, car il faut un compte manager sur ce serveur. Ce que cela signifie varie selon votre configuration. Pour voir quelle configuration FXUP vous donne l’accès dont vous avez besoin, avec les prix et conditions en vigueur sur le même écran, comparez les options dans l’outil de recherche de solution.
| Montage | Qui contrôle le serveur | Ce que vous pouvez généralement obtenir |
|---|---|---|
| Licence MT5 en propre | Votre société | Accès complet ; vous créez vous-même les managers et fixez leurs droits |
| White label MT5 | Le titulaire de la licence | Un manager limité à vos groupes, si le contrat le permet |
| Grey label MT5 | Le fournisseur | Variable selon le fournisseur ; avec FXUP, un compte Manager dédié qui ne voit que vos utilisateurs, plus un accès à la Manager API et au SDK après paiement |
Que doit contenir la check-list d’une intégration MT5 Web API ?
Avant d’écrire du code, réglez les points qui coûtent cher à modifier ensuite. Voici la liste que nous passons en revue avec les clients qui connectent un CRM pour courtiers, un espace client ou une interface ; elle vaut aussi pour les autres intégrations sur mesure que nous réalisons :
- La version (build) du serveur et la forme de Web API (HTTPS, binaire ou les deux) que vous utiliserez.
- Un compte manager dédié, ses droits et les groupes qu’il peut voir.
- Les événements qui déclenchent la création de comptes, les mouvements de solde et les changements de groupe, et qui les valide.
- La fréquence d’interrogation par type de données et les commandes groupées qui la couvrent.
- La gestion des fuseaux horaires et un point de conversion unique.
- Ce qui se passe en cas de délai d’attente dépassé pour chaque opération, en particulier les ordres et les mouvements de solde.
- La supervision : une alerte quand la connexion MT5 tombe, pas une réclamation de client.
Questions fréquentes
Qu’est-ce que la MetaTrader 5 Web API ?
La MT5 Web API est-elle une API REST ?
Puis-je construire mon propre WebTrader sur la MT5 Web API ?
La Web API donne-t-elle accès à la profondeur de marché ?
Quelle différence entre la Web API et la Manager API ?
Un courtier en grey label peut-il obtenir un accès API ?
La MT5 Web API a-t-elle des limites de requêtes ?
La MT5 Web API est-elle sécurisée ?
Combien de temps prend une intégration MT5 Web API ?
Ai-je besoin d’une autorisation de MetaQuotes pour utiliser la Web API ?
Votre question n’y est pas ? Ouvrez l’outil de recherche de solution et découvrez la configuration, les prix et les conditions adaptés à votre situation.
Sources
- MetaQuotes — MetaTrader 5 trading platform for brokers and banks (consulté en octobre 2026)
- MetaQuotes — MetaTrader 5 for brokers (metaquotes.net) (consulté en octobre 2026)
- MetaQuotes — Liquidity providers for MetaTrader 5 (consulté en octobre 2026)
- MQL5 Reference — Python integration for the MetaTrader 5 terminal (consulté en octobre 2026)
FXUP est un cabinet de conseil et une société technologique indépendants et n’est pas affiliée à MetaQuotes Ltd. MetaTrader 4 et MetaTrader 5 sont des marques de MetaQuotes Ltd. Cette page fournit une information générale et ne constitue pas un conseil juridique, fiscal ou en investissement ; les exigences réglementaires dépendent de chaque juridiction et évoluent dans le temps. Les prix et conditions en vigueur de FXUP sont présentés dans l’outil de recherche de solution.
Comment fonctionne l’authentification à la MT5 Web API ?
Votre application s’authentifie en tant que manager MT5 au moyen d’un échange défi-réponse, si bien que le mot de passe du manager ne circule jamais en clair. Sous la forme HTTPS que nous utilisons, il faut deux appels :