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

MQL5 · Ordres et positions

OnTradeTransaction en MQL5 : réagir aux ordres, deals et positions en temps réel

OnTradeTransaction signale chaque ajout d’ordre, de deal ou de modification de position. Types de transactions, champs remplis, ordre non garanti et exemple d’EA qui suit ses exécutions.

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

OnTradeTransaction est le gestionnaire d’événements que MetaTrader 5 appelle dans un Expert Advisor à chaque transaction sur le compte : ajout, modification ou suppression d’un ordre, ajout d’un deal à l’historique, modification d’une position, traitement d’une requête par le serveur. Sa signature est void OnTradeTransaction(const MqlTradeTransaction& trans, const MqlTradeRequest& request, const MqlTradeResult& result). Le champ trans.type indique la nature de l’événement ; pour réagir à une exécution, on filtre en général TRADE_TRANSACTION_DEAL_ADD.

Ce gestionnaire permet de réagir immédiatement, sans attendre le tick suivant : poser des stops dès l’exécution d’un ordre en attente, enregistrer le résultat d’une sortie, compter les pertes consécutives. Cette page fait partie de la rubrique Ordres et positions en MQL5.

Ce que dit la documentation

Les points essentiels de la documentation officielle :

  • la fonction est appelée dans les Expert Advisors lorsque survient l’événement TradeTransaction ;
  • les événements proviennent des requêtes envoyées par OrderSend ou OrderSendAsync, des requêtes manuelles, de l’activation d’ordres en attente et de stops par le serveur, et des opérations effectuées côté serveur ;
  • une seule requête produit une chaîne de transactions ; par exemple, un achat au marché donne lieu à l’ajout d’un ordre, à son exécution, à son passage dans l’historique, à l’ajout d’un deal et à la création d’une position ;
  • l’ordre d’arrivée de ces transactions n’est pas garanti : ne supposez pas qu’un groupe arrive avant un autre ;
  • le terminal continue de traiter les transactions entrantes pendant l’exécution du gestionnaire, et l’état du compte peut changer pendant l’appel ;
  • la file des transactions contient 1024 éléments ; si le gestionnaire traite trop longtemps une transaction, les plus anciennes peuvent être écrasées ;
  • OnTrade() est appelée après les appels correspondants à OnTradeTransaction(), sans correspondance un pour un.

Les types de transactions

L’énumération ENUM_TRADE_TRANSACTION_TYPE contient onze valeurs :

TypeSignification
TRADE_TRANSACTION_ORDER_ADDajout d’un nouvel ordre actif
TRADE_TRANSACTION_ORDER_UPDATEmodification d’un ordre actif, y compris changement d’état
TRADE_TRANSACTION_ORDER_DELETEretrait d’un ordre de la liste des ordres actifs
TRADE_TRANSACTION_DEAL_ADDajout d’un deal à l’historique
TRADE_TRANSACTION_DEAL_UPDATEmodification d’un deal de l’historique
TRADE_TRANSACTION_DEAL_DELETEsuppression d’un deal de l’historique
TRADE_TRANSACTION_HISTORY_ADDajout d’un ordre à l’historique (exécution ou annulation)
TRADE_TRANSACTION_HISTORY_UPDATEmodification d’un ordre de l’historique
TRADE_TRANSACTION_HISTORY_DELETEsuppression d’un ordre de l’historique
TRADE_TRANSACTION_POSITIONmodification d’une position non liée à l’exécution d’un deal
TRADE_TRANSACTION_REQUESTune requête a été traitée par le serveur et son résultat est reçu

Deux subtilités : TRADE_TRANSACTION_POSITION n’est pas émise quand une position est ouverte, modifiée ou fermée par un deal ; elle signale un changement effectué côté serveur (volume, prix d’ouverture, stops). Et seule TRADE_TRANSACTION_REQUEST remplit les paramètres request et result ; pour les autres types, ils ne contiennent pas de données exploitables.

La structure MqlTradeTransaction

Ses champs sont deal, order, symbol, type, order_type, order_state, deal_type, time_type, time_expiration, price, price_trigger, price_sl, price_tp, volume, position et position_by. Ils ne sont pas tous remplis pour chaque type :

  • pour DEAL_ADD, DEAL_UPDATE, DEAL_DELETE : deal, order, symbol, type, deal_type, price, price_sl, price_tp, volume, position, et position_by pour une fermeture par position opposée ;
  • pour les types ORDER_* et HISTORY_* : les champs de l’ordre (ticket, type, état, prix, volume courant…) ;
  • pour POSITION : symbole, sens, prix moyen, stops et volume s’il a changé ;
  • pour REQUEST : seulement type.

Le magic number ne fait pas partie de la structure. Pour savoir si un deal appartient à votre EA, sélectionnez-le dans l’historique et lisez DEAL_MAGIC.

Exemple : réagir aux exécutions de l’EA

Cet Expert Advisor journalise le résultat de chaque requête traitée, détecte les entrées et sorties qui le concernent, et tient un compteur de pertes consécutives.

//+------------------------------------------------------------------+
//| OnTradeTransaction : suivre les exécutions de l'EA               |
//+------------------------------------------------------------------+
input ulong InpMagic = 240515;

int g_losses_in_row = 0;     // pertes consécutives

void OnTradeTransaction(const MqlTradeTransaction &trans,
                        const MqlTradeRequest     &request,
                        const MqlTradeResult      &result)
  {
   //--- 1. résultat d'une requête : seul type où request/result sont remplis
   if(trans.type == TRADE_TRANSACTION_REQUEST)
     {
      if(request.magic == InpMagic && result.retcode != TRADE_RETCODE_DONE &&
         result.retcode != TRADE_RETCODE_PLACED)
         PrintFormat("Requête refusée : %u %s", result.retcode, result.comment);
      return;
     }

   //--- 2. nouveau deal dans l'historique
   if(trans.type != TRADE_TRANSACTION_DEAL_ADD) return;
   if(!HistoryDealSelect(trans.deal))               // charge ce deal
     {
      PrintFormat("Deal %I64u introuvable dans l'historique", trans.deal);
      return;
     }
   if((ulong)HistoryDealGetInteger(trans.deal, DEAL_MAGIC) != InpMagic) return;

   long entry = HistoryDealGetInteger(trans.deal, DEAL_ENTRY);
   if(entry == DEAL_ENTRY_IN)
     {
      PrintFormat("Entrée : position %I64u, %.2f lot à %.5f",
                  trans.position, trans.volume, trans.price);
      return;
     }

   if(entry == DEAL_ENTRY_OUT || entry == DEAL_ENTRY_OUT_BY)
     {
      double net = HistoryDealGetDouble(trans.deal, DEAL_PROFIT)
                 + HistoryDealGetDouble(trans.deal, DEAL_COMMISSION)
                 + HistoryDealGetDouble(trans.deal, DEAL_SWAP);
      g_losses_in_row = (net < 0.0) ? g_losses_in_row + 1 : 0;
      PrintFormat("Sortie : position %I64u, résultat %.2f, pertes consécutives %d",
                  trans.position, net, g_losses_in_row);
     }
  }

void OnTick()
  {
   // ... la logique d'entrée peut consulter g_losses_in_row
  }

Le gestionnaire reste court : il lit quelques propriétés et met à jour une variable. Les traitements lourds (calculs statistiques, écritures de fichiers) doivent être faits ailleurs, par exemple dans OnTimer, pour ne pas risquer de saturer la file de 1024 transactions. Le résultat de sortie calculé ici ne porte que sur le deal de sortie ; pour le résultat complet d’une position, voir Lire l’historique des ordres et transactions.

OnTradeTransaction, OnTrade ou OnTick ?

BesoinOutil adapté
Réagir à une exécution précise, avec son ticketOnTradeTransaction
Savoir qu’« il s’est passé quelque chose » et relire l’état completOnTrade, appelée après les transactions
Gérer les positions en fonction du prixOnTick
Suivre le résultat d’envois asynchrones (OrderSendAsync)OnTradeTransaction, avec TRADE_TRANSACTION_REQUEST et result.request_id

OnTrade ne transmet aucun paramètre : elle signale un changement et laisse le programme relire ordres, positions et historique. OnTradeTransaction donne le détail de chaque étape. La documentation de OnTrade précise qu’elle n’est appelée que pour les Expert Advisors. Pour une vue d’ensemble des gestionnaires d’événements, voir Les fonctions événementielles.

Cas d’usage en trading

Poser les stops après le déclenchement d’un ordre en attente. Dès le deal d’entrée, l’EA peut calculer des stops fondés sur le prix réel d’exécution plutôt que sur le prix prévu.

Coupe-circuit immédiat. Après une sortie perdante, l’EA met à jour son compteur et peut suspendre les entrées sans attendre le tick suivant, utile sur un symbole peu actif.

Mesure du glissement. Le prix du deal (trans.price) comparé au prix demandé mesure le glissement réel de chaque exécution, une donnée exploitée dans Gérer spread et slippage dans un EA.

Mode asynchrone. Avec OrderSendAsync, le seul moyen de connaître le sort d’une requête est cet événement : le champ request_id de MqlTradeResult sert, selon la documentation, à relier le résultat d’un envoi à l’événement correspondant.

Pièges fréquents

Supposer un ordre d’arrivée. Ne codez pas « après ORDER_DELETE vient DEAL_ADD » : la documentation dit explicitement que cet ordre n’est pas garanti. Chaque branche du gestionnaire doit être autonome.

Lire request et result pour tous les types. Ils ne sont remplis que pour TRADE_TRANSACTION_REQUEST.

Traiter tous les deals du compte. Les deals manuels et ceux des autres EA déclenchent aussi l’événement ; filtrez par DEAL_MAGIC et symbole.

Dépendre uniquement de l’événement. Si le terminal est arrêté au moment d’une exécution, l’événement est perdu pour votre EA. Au redémarrage, reconstruisez l’état à partir des positions ouvertes et de l’historique.

Un gestionnaire d’événements qui déclenche automatiquement de nouveaux ordres peut provoquer des enchaînements rapides en cas de bug. Le trading avec effet de levier comporte un risque élevé de perte en capital ; testez ce code sur un compte de démonstration.

FAQ

OnTradeTransaction est-elle appelée pour les trades manuels ?

Oui : selon la documentation, les requêtes manuelles et les opérations côté serveur produisent aussi des transactions. Filtrez par magic number pour ne traiter que celles de votre EA.

Pourquoi request.magic est-il vide dans mon gestionnaire ?

Parce que request et result ne sont remplis que pour les transactions de type TRADE_TRANSACTION_REQUEST. Pour un deal, lisez DEAL_MAGIC dans l’historique.

Combien de fois le gestionnaire est-il appelé pour un ordre au marché ?

Plusieurs fois : la documentation cite l’ajout d’ordre, l’exécution, l’ajout à l’historique, l’ajout du deal et la création de la position, plus la notification de la requête. Le nombre exact et l’ordre ne doivent pas être supposés.

Peut-on utiliser OnTradeTransaction dans un indicateur ?

La documentation la décrit comme appelée dans les Expert Advisors. Pour un suivi des transactions, placez la logique dans un EA.

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.