MT5 Manager API, Web API ou Server API

Qu’est-ce que la MT5 Manager API ?

La MT5 Manager API est l’interface que MetaQuotes met à disposition pour écrire vos propres logiciels d’administration et de gestion d’un serveur MetaTrader 5. Tout ce que fait un collaborateur du back-office dans le terminal MT5 Manager — ouvrir des comptes, les déplacer d’un groupe à l’autre, enregistrer des dépôts, surveiller les positions, traiter les requêtes des dealers — peut en principe être réalisé par un programme construit sur cette API.

Elle est fournie aux titulaires de licence dans le cadre des packages développeur de MetaQuotes, et non en téléchargement public, et sa documentation se trouve sur le site d’assistance de MetaQuotes, accessible après connexion. Dans les packages avec lesquels nous avons travaillé, il s’agit d’une bibliothèque native pour Windows, avec des en-têtes pour C++ et des wrappers pour .NET ; vérifiez le package actuel correspondant au build de votre serveur, car les détails évoluent.

Comment se comparent la Manager API, la Web API et la Server API ?

Le moyen le plus rapide de les distinguer est de se demander où s’exécute le code et ce qui se passe s’il plante. Les programmes construits sur la Manager API et la Web API s’exécutent hors du serveur et s’y connectent ; un plugin Server API s’exécute à l’intérieur, à chaque événement concerné.

Quelle place pour la Gateway API et la Report API ?

Elles complètent l’ensemble, mais répondent à d’autres questions. La Gateway API connecte MT5 à d’autres systèmes de trading et flux de données : c’est ainsi que l’on raccorde les fournisseurs de liquidité et les bourses ; nous la traitons dans le guide MT5 Gateway API. La Report API étend les rapports produits par le serveur de trading, ce qui compte pour le reporting réglementaire et de gestion.

Aucune des deux ne remplace la Manager API ou la Web API. Un CRM qui doit ouvrir des comptes n’utilisera jamais la Gateway API, et une connexion de liquidité ne sera jamais construite sur la Web API.

Qu’automatisent les courtiers avec la Manager API ?

Les courtiers utilisent la Manager API surtout pour des tâches que leurs collaborateurs feraient sinon à la main dans le terminal Manager, à grande échelle ou en continu. Exemples courants tirés de projets que nous avons vus :

• Administration des comptes — création de comptes en masse, transfert de clients d’un groupe à l’autre, modification de l’effet de levier après une évaluation du caractère approprié.
• Opérations de solde — enregistrement des dépôts, retraits, crédits et corrections à partir d’une file de paiements validés.
• Outils de négociation et de risque — écrans sur mesure pour l’exposition nette par symbole, alertes sur les grosses positions et rentabilité par client.
• Reporting des apporteurs d’affaires — extraction des transactions pour le calcul des commissions en fin de journée.
• Contrôles de conformité — signalement des comptes dont l’activité sort des schémas attendus ou qui conservent des positions le week-end.
• Maintenance — archivage des comptes inactifs, nettoyage des groupes de test, vérification des paramètres de symboles par rapport à une liste de référence.

Exemple concret : de la validation KYC à la première transaction

Supposons qu’un courtier valide un nouveau client dans son CRM un mardi à 10 h. Voici comment le travail se répartit entre les interfaces dans une intégration type ; dans un CRM web, comme le nôtre, les appels de niveau manager passent généralement par la Web API.

1. KYC validéLe responsable de la conformité valide les documents dans le CRM. Le CRM vérifie le pays du client et lui attribue le bon groupe MT5.
2. Compte crééLe CRM appelle le serveur en tant que manager pour créer le compte avec le nom, le groupe, l’effet de levier et un mot de passe généré, puis affiche l’identifiant dans l’espace client.
3. Dépôt créditéLe prestataire de paiement confirme un dépôt par carte. Après les contrôles propres au CRM, une opération de solde est enregistrée sur le compte, avec la référence du paiement en commentaire.
4. Le client négocieLe client se connecte au WebTrader ou à l’application et ouvre une position. Un plugin Server API, si le courtier en a un, peut appliquer des règles sur mesure à ce stade.
5. ReportingPendant la nuit, une tâche de reporting lit les transactions de la journée pour les commissions d’IB et le tableau de bord de l’équipe risques.

Quand la Web API est-elle préférable à la Manager API ?

La Web API est généralement le meilleur choix lorsque le consommateur est un service web fonctionnant sous Linux, dans le cloud ou dans un autre langage que C++ ou .NET. Elle utilise HTTPS et JSON : un CRM écrit en PHP, Node.js, Go ou Python peut donc s’en servir sans bibliothèque native. C’est pourquoi la plupart des CRM et des espaces client, dont le nôtre, sont construits sur elle.

La Manager API se justifie lorsque vous développez un outil desktop pour les dealers, avez besoin de l’ensemble des fonctions manager dans une application native, ou souhaitez réagir aux événements du serveur sans interrogation périodique. Un outil de suivi du risque qui doit afficher l’évolution de l’exposition en temps réel en est un cas typique. Notre guide de la MetaTrader 5 Web API détaille les limites de la Web API.

Qu’est-ce qu’un plugin MT5 Server API, et quand en avez-vous besoin ?

Un plugin Server API est du code qui s’exécute à l’intérieur du serveur de trading ou d’historique MetaTrader 5 et qui est appelé au fil des événements — une requête de trading, une transaction, une modification de compte. Vous en avez besoin lorsqu’une règle doit être appliquée à chaque opération, avant que le résultat ne soit définitif, et ne peut pas attendre qu’un programme extérieur s’en aperçoive.

Parmi les exemples : des contrôles de marge ou d’exposition sur mesure, des règles de bonus qui dépendent du volume négocié, une logique de copy trading qui doit réagir immédiatement, ou des données supplémentaires inscrites sur les transactions pour le reporting. Cette puissance est aussi le risque : un plugin lent ou défaillant ralentit ou arrête le serveur pour tout le monde. Nous conseillons à nos clients de garder des plugins réduits, de les tester sur un serveur distinct avec une charge réaliste, et de laisser à l’extérieur du serveur tout ce qui peut y être exécuté.

Quelle API MT5 utiliser pour chaque tâche d’un courtier ?

Choisissez l’interface en fonction de la tâche, et non de celle que votre développeur connaît déjà. Le tableau reflète la façon dont nous réaliserions chaque élément aujourd’hui.

Qui peut obtenir un accès à la MT5 Manager API ?

L’accès est accordé par le propriétaire du serveur MT5, car chaque compte manager est créé sur ce serveur. Avec votre propre licence MT5, vous décidez qui obtient quel compte manager et quels packages développeur vous utilisez. En white label, c’est le titulaire de la licence qui décide, et le compte manager qui vous est attribué est normalement limité à vos groupes. En grey label MT5, vous travaillez généralement via le CRM et les interfaces du fournisseur, sans détenir d’identifiants manager bruts.

C’est l’une des questions à régler avant de signer. Si vos projets comprennent un outil de négociation sur mesure ou un CRM interne, demandez par écrit à votre fournisseur quel niveau d’accès aux API vous obtiendrez, et à quelles conditions. Nous sommes indépendants et FXUP n’est pas affiliée à MetaQuotes ; pour les questions de licence portant sur les packages d’API eux-mêmes, l’interlocuteur compétent est MetaQuotes ou votre fournisseur de serveur. Si vous demandez votre propre licence MT5, nous prenons en charge, moyennant rémunération, les exigences de MetaQuotes et la demande pour nos clients, dans le cadre d’une mission de conseil.

Vous ne savez pas quoi demander ? Envoyez-nous un message WhatsApp décrivant votre configuration, et nous vous suggérerons la formulation.

Et les services tiers d’« API MT5 » ?

Beaucoup de produits vendus comme une « API MT5 » ne sont pas du tout les API courtier de MetaQuotes. Certains se connectent à des comptes de trading individuels en faisant tourner des terminaux dans le cloud de l’éditeur ; d’autres encapsulent le package Python de MetaQuotes, qui dialogue avec un terminal desktop installé sur la même machine. Ils conviennent aux traders, aux services de signaux et à l’analyse de données, et fonctionnent avec les comptes de n’importe quel courtier.

D’autres encore sont des wrappers hébergés autour de la Manager API ou de la Web API, qui offrent une interface REST au-dessus d’une connexion manager. Ils peuvent faire gagner du temps de développement, mais vos identifiants manager se retrouvent alors chez un tiers, et vous dépendez de sa disponibilité et de son rythme de mises à jour lorsque MetaQuotes publie un nouveau build. Demandez où le service est hébergé, qui peut voir les identifiants et ce que devient votre intégration si l’éditeur cesse son activité.

Comment sécuriser une intégration de niveau manager ?

Traitez chaque compte manager utilisé par un logiciel comme un compte système à privilèges, car c’est exactement ce qu’il est. Les règles que nous appliquons à nos propres intégrations :

• Un compte manager par intégration, avec uniquement les droits et les groupes dont cette intégration a besoin.
• Des opérations de solde uniquement à partir d’une file validée, jamais directement depuis une requête émanant d’un client.
• Des identifiants conservés dans un coffre de secrets et renouvelés à chaque changement de personnel ou de prestataire.
• Des connexions autorisées uniquement depuis des serveurs connus.
• Chaque écriture journalisée avec son motif métier et rapprochée quotidiennement.
• Aucune nouvelle tentative automatique de mouvement de fonds ou de transaction après expiration du délai ; vérifiez d’abord l’état du serveur.

Quelles sont les erreurs courantes dans les projets MT5 Manager API ?

Les erreurs courantes sont des erreurs d’architecture, et la plupart sont commises dès la première semaine. Elles coûtent peu à éviter et cher à corriger une fois que les clients dépendent du système.

• Un seul compte manager pour tout. Le CRM, la tâche de reporting et l’outil des dealers partagent un identifiant doté de tous les droits : personne ne peut savoir quel système a effectué une modification, et aucun d’eux ne peut être révoqué séparément.
• Interroger compte par compte. Un espace client qui demande tour à tour les positions de chaque client fonctionne avec 50 comptes et ralentit le serveur à 5 000. Utilisez des requêtes groupées et mettez en cache ce qui ne change pas.
• De la logique métier dans un plugin. Une règle de copy trading ou de bonus écrite sous forme de plugin Server API parce qu’elle semblait « plus proche du serveur », alors qu’elle aurait pu s’exécuter sans risque à l’extérieur.
• Ignorer l’heure du serveur. Des transactions stockées dans le CRM à l’heure du serveur et comparées à des enregistrements de paiement en UTC : les rapprochements quotidiens sont décalés de deux ou trois heures.
• Relancer des mouvements de fonds. Un appel de dépôt dépasse le délai, le code réessaie, et le client est crédité deux fois. Vérifiez l’historique du compte avant toute nouvelle tentative.
• Aucun plan pour les mises à jour de MT5. MetaQuotes publie régulièrement de nouveaux builds. Gardez un serveur de test sur le build suivant et faites-y tourner votre intégration avant la mise à jour du serveur de production.

Un projet de prop firm ou de copy trading change-t-il le choix ?

Oui, un peu. La technologie pour le trading pour compte propre repose largement sur des actions rapides sur les comptes, fondées sur des règles, comme la clôture d’un compte d’évaluation dès qu’une limite de drawdown est franchie. Certaines sociétés le font de l’extérieur, via la Web API ou la Manager API, avec des contrôles fréquents ; d’autres préfèrent un plugin, pour que la règle soit appliquée à l’intérieur du serveur. Le compromis oppose le temps de réaction au risque d’exécuter du code sur mesure sur le serveur.

Le copy trading et le PAMM se trouvent dans une situation comparable. La copie elle-même peut s’exécuter hors du serveur, mais la répartition des volumes et des frais doit être exacte : l’interface choisie doit donc vous fournir des données de transactions fiables et un moyen de les rapprocher. La liquidité est encore un autre sujet : si le projet nécessite aussi de nouveaux fournisseurs, consultez notre page intégration des fournisseurs de liquidité.

Comment FXUP travaille-t-elle avec les API MT5 ?

Notre WebTrader à votre marque, nos applications mobiles et notre propre CRM pour courtiers se connectent à MT5 via un back-end Go qui utilise la Web API. Nous travaillons aussi avec des CRM partenaires et proposons celui qui convient au projet ; dans tous les cas, nous vérifions de quelle interface et de quels droits manager le CRM a besoin avant toute mise en production. Pour les clients disposant de leur propre serveur, nous cadrons aussi des outils pour les dealers, des tâches de reporting et, à l’occasion, un plugin, et nous vous dirons quand une fonction MT5 existante ou une interface plus simple ferait l’affaire.

Si vous comparez des devis pour un projet d’API, envoyez-nous le cahier des charges sur WhatsApp ; nous pouvons vous dire quelle interface requiert chaque élément et où se cache le travail. Notre page intégrations sur mesure liste les types de projets que nous prenons en charge.

Questions fréquentes

Votre question n’y est pas ? Posez-la sur WhatsApp, écrivez à @FXUPCK sur Telegram ou par e-mail à [email protected].