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.
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
OrderSendouOrderSendAsync, 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 :
| Type | Signification |
|---|---|
TRADE_TRANSACTION_ORDER_ADD | ajout d’un nouvel ordre actif |
TRADE_TRANSACTION_ORDER_UPDATE | modification d’un ordre actif, y compris changement d’état |
TRADE_TRANSACTION_ORDER_DELETE | retrait d’un ordre de la liste des ordres actifs |
TRADE_TRANSACTION_DEAL_ADD | ajout d’un deal à l’historique |
TRADE_TRANSACTION_DEAL_UPDATE | modification d’un deal de l’historique |
TRADE_TRANSACTION_DEAL_DELETE | suppression d’un deal de l’historique |
TRADE_TRANSACTION_HISTORY_ADD | ajout d’un ordre à l’historique (exécution ou annulation) |
TRADE_TRANSACTION_HISTORY_UPDATE | modification d’un ordre de l’historique |
TRADE_TRANSACTION_HISTORY_DELETE | suppression d’un ordre de l’historique |
TRADE_TRANSACTION_POSITION | modification d’une position non liée à l’exécution d’un deal |
TRADE_TRANSACTION_REQUEST | une 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, etposition_bypour une fermeture par position opposée ; - pour les types
ORDER_*etHISTORY_*: 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: seulementtype.
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 ?
| Besoin | Outil adapté |
|---|---|
| Réagir à une exécution précise, avec son ticket | OnTradeTransaction |
| Savoir qu’« il s’est passé quelque chose » et relire l’état complet | OnTrade, appelée après les transactions |
| Gérer les positions en fonction du prix | OnTick |
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.
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.
- Ordres, positions et transactions : le modèle de MT5
- Comptes netting ou hedging
- La classe CTrade
- OrderSend et MqlTradeRequest
- OrderCheck : vérifier un ordre avant envoi
- Ouvrir une position au marché
- Ordres limites et stop
- Placer et modifier stop loss et take profit
- Coder un trailing stop
- Passer une position à break-even
- Fermer une position (totale ou partielle)
- Parcourir et filtrer les positions
- Le magic number
- Lire l’historique des ordres et transactions
- Modes de remplissage (FOK, IOC, Return)
- Gérer spread et slippage dans un EA
- Calculer et normaliser la taille de lot
