📚 Guide d'IntĂ©gration

Intégrez la librairie TradingDataSenderLibrary dans votre Expert Advisor MQL5 en quelques étapes simples

1
Télécharger la Librairie

Téléchargez le fichier tdsl.ex5 contenant toutes les librairies nécessaires.

đŸ“„ TĂ©lĂ©charger tdsl.ex5

Une fois téléchargé, placez le fichier tdsl.ex5 dans le dossier MQL5/Experts de votre installation MetaTrader 5, à cÎté de votre Expert Advisor.

💡 Astuce
Le chemin complet devrait ressembler Ă  :
C:\Users\Nom\AppData\Roaming\MetaQuotes\Terminal\...\MQL5\Experts\
2
Autoriser les importations DLL

Pour que la librairie fonctionne, il est indispensable d'autoriser les importations DLL dans MetaTrader 5.

  1. Ouvrez MetaTrader 5 et allez dans Outils > Options (Ctrl + O).
  2. Rendez-vous dans l’onglet Experts ou Expert Advisor.
  3. Cochez l’option : Autoriser l’importation de DLL
💡 Astuce
Cette option permet Ă  votre Expert Advisor d'utiliser des librairies externes de tdsl.ex5.
Vous pouvez Ă©galement activer l’option Autoriser l’importation de DLL directement sur le graphique de l’EA (clic-droit > PropriĂ©tĂ©s > Commun).
3
Créer un Compte et Récupérer la Clé API

Pour utiliser le service, vous devez créer un compte et récupérer votre clé API unique.

🔐 CrĂ©er un compte 🔑 Se connecter

Une fois connecté, votre clé API sera affichée dans le dashboard. Vous pourrez la copier facilement pour l'utiliser dans votre EA.

🔒 SĂ©curitĂ©
Gardez votre clé API secrÚte. Elle permet d'identifier vos sessions de trading et d'accéder à vos données.
4
Importer et Configurer la Librairie

Dans votre fichier Expert Advisor (.mq5), importez la librairie tdsl.ex5 via #import et dĂ©clarez les variables nĂ©cessaires :

Code MQL5 à intégrer 
#import "tdsl.ex5"
    void* TDSL_Create();
    bool  TDSL_Initialize(string apiKey, string url, int batch);
    bool  TDSL_SendNewPositionsBatch(bool force);
    void  TDSL_Close(int magic_number);
    bool  TDSL_IsInitialized();
#import

input group "=== Data Sender ==="
input bool enable_data_sender = true; // Activer Data Sender
input string api_key = "";            // Clé API
⚠ Important
N'oubliez pas de remplacer api_key = "" par votre vraie clé API récupérée à l'étape 3.
5
Initialiser la Librairie

Dans la fonction OnInit() de votre EA, ajoutez le code d'initialisation :

Code MQL5 à intégrer dans OnInit() 
if(enable_data_sender) {
    TDSL_Create();
    if(TDSL_Initialize(api_key, 100)) {
        Print("Data sender init success");
    } else {
        Print("Data sender init error");
    }
}
💡 Explication
Cette fonction initialise la librairie native et tente de se connecter au serveur avec votre clé API. Un message dans les logs indiquera si l'initialisation a réussi ou échoué.
6
Envoyer les Données

Dans la fonction OnTick() ou OnTimer() de votre EA, ajoutez l'envoi des données :

Code MQL5 à intégrer dans OnTick() ou OnTimer() 
if(enable_data_sender && TDSL_IsInitialized()) {
    TDSL_SendNewPositionsBatch(false);
}
💡 Explication
Cette fonction envoie automatiquement toutes les nouvelles positions ouvertes ou fermées depuis le dernier appel. Le paramÚtre false indique qu'on n'attend pas la réponse du serveur (envoi asynchrone).
7
Fermer la Session

Dans la fonction OnDeinit() de votre EA, ajoutez le code de fermeture :

Code MQL5 à intégrer dans OnDeinit() 
if(enable_data_sender && TDSL_IsInitialized()) {
    TDSL_Close(420420); //Remplacer par votre magic number
}
💡 Explication
TDSL_Close() envoie les derniÚres données et ferme proprement la session. Remplacez 420420 par le magic number de votre EA.
8
Assurer la fermeture lors du backtest

Pour garantir que les donnĂ©es sont bien envoyĂ©es jusqu'au bout, mĂȘme en mode test ou optimisation, ajoutez dans la fonction OnTesterDeinit() de votre EA :

Code MQL5 à intégrer dans OnTesterDeinit() 
void OnTesterDeinit() {
   if(enable_data_sender && TDSL_IsInitialized()) {
       TDSL_Close(420420); //Remplacer par votre magic number
   }
}
💡 Explication
Ce code permet de s'assurer qu'en toutes circonstances (y compris lors d'un backtest ou d'une optimisation automatique), la fonction TDSL_Close() est bien appelée pour transmettre toutes les données et terminer proprement la session. Remplacez 420420 par le magic number de votre EA.
✔
FĂ©licitations !

🎉 Bravo, vous avez terminĂ© toutes les Ă©tapes !
Votre stratĂ©gie est maintenant prĂȘte Ă  envoyer les donnĂ©es automatiquement Ă  votre tableau de bord.

Vous pouvez suivre vos ordres, backtests et statistiques en temps réel sur le dashboard.

🚀 Astuce suivante
  • Retrouvez toutes vos donnĂ©es et historiques sur votre dashboard.
  • Analysez vos performances et ajustez votre EA en toute simplicitĂ©.
  • SĂ©curisez votre clĂ© API, ne la partagez Ă  personne.

Pour aller plus loin : testez diffĂ©rentes stratĂ©gies, utilisez l’optimisation automatique de MetaTrader 5, les rĂ©sultats remonteront Ă©galement dans le tableau de bord !
🎯 AccĂ©der au Dashboard