MQL5 · Ordres et positions
Ordres, positions et transactions en MQL5 : comprendre le modèle de MetaTrader 5
Ordre, deal, position : trois objets distincts dans MetaTrader 5. Comprendre ce qui les relie, notamment POSITION_IDENTIFIER, évite la plupart des bugs de comptage et de suivi dans un EA.
Dans MetaTrader 5, un ordre est une demande adressée au serveur, une transaction (deal) est l’exécution effective d’un ordre, et une position est l’engagement ouvert qui résulte d’une ou plusieurs transactions. Un achat au marché produit donc trois objets distincts, chacun avec son ticket et ses propriétés, et votre Expert Advisor doit savoir lequel interroger selon la question qu’il se pose.
Cette distinction est le point de départ de toute la rubrique Ordres et positions en MQL5. Elle explique pourquoi les fonctions de trading MQL5 sont réparties en quatre familles : ordres actifs, positions, historique des ordres et historique des transactions.
Les trois objets du modèle
L’ordre : une instruction
Un ordre exprime une intention : acheter ou vendre un volume, immédiatement (ordre au marché) ou sous condition de prix (ordre en attente). La documentation énumère ses types dans ENUM_ORDER_TYPE : ORDER_TYPE_BUY, ORDER_TYPE_SELL, les ordres limites et stop (ORDER_TYPE_BUY_LIMIT, ORDER_TYPE_SELL_LIMIT, ORDER_TYPE_BUY_STOP, ORDER_TYPE_SELL_STOP), les ordres stop-limit et ORDER_TYPE_CLOSE_BY, qui ferme une position par une position opposée.
Un ordre traverse plusieurs états décrits par ENUM_ORDER_STATE : ORDER_STATE_STARTED (vérifié mais pas encore accepté par le broker), ORDER_STATE_PLACED (accepté), ORDER_STATE_PARTIAL (partiellement exécuté), ORDER_STATE_FILLED (entièrement exécuté), mais aussi ORDER_STATE_CANCELED, ORDER_STATE_REJECTED et ORDER_STATE_EXPIRED. Un ordre en attente reste dans la liste des ordres actifs (OrdersTotal) tant qu’il n’est ni exécuté, ni annulé, ni expiré. Ensuite, il passe dans l’historique des ordres.
Un ordre au marché ne reste quasiment jamais visible dans la liste des ordres actifs : il est exécuté puis déplacé dans l’historique presque immédiatement. C’est l’une des raisons pour lesquelles compter les ordres actifs pour savoir si l’on est « en position » est une erreur classique.
La transaction (deal) : une exécution
Chaque exécution d’un ordre crée une transaction dans l’historique. La documentation le formule ainsi : chaque deal est le résultat de l’exécution d’un ordre. Un ordre de 1 lot exécuté en deux fois (remplissage partiel) produit deux deals. Les deals portent les informations financières réelles : DEAL_PRICE (prix d’exécution), DEAL_VOLUME, DEAL_PROFIT, DEAL_COMMISSION, DEAL_SWAP, DEAL_FEE.
La propriété DEAL_ENTRY indique le rôle du deal vis-à-vis de la position :
| Valeur | Signification |
|---|---|
DEAL_ENTRY_IN | ouverture ou augmentation d’une position |
DEAL_ENTRY_OUT | sortie (totale ou partielle) d’une position |
DEAL_ENTRY_INOUT | retournement de la position (netting) |
DEAL_ENTRY_OUT_BY | fermeture par une position opposée |
Les deals ne concernent pas que le trading : DEAL_TYPE_BALANCE, DEAL_TYPE_CREDIT ou DEAL_TYPE_CHARGE enregistrent des dépôts, crédits ou frais. Un EA qui additionne les profits de l’historique doit donc filtrer les deals de type DEAL_TYPE_BUY et DEAL_TYPE_SELL.
La position : un engagement ouvert
Une position est la synthèse d’une ou plusieurs transactions. Elle possède un type (POSITION_TYPE_BUY ou POSITION_TYPE_SELL), un volume, un prix moyen d’ouverture (POSITION_PRICE_OPEN), un stop loss et un take profit, un profit flottant (POSITION_PROFIT) et un swap. Ce sont les positions, et non les ordres, qui exposent votre compte au marché.
Le nombre de positions possibles par symbole dépend du mode de comptabilité du compte : une seule en netting, plusieurs en hedging. Ce point est détaillé dans la page Comptes netting ou hedging.
Le fil qui relie tout : POSITION_IDENTIFIER
Comment retrouver les ordres et les deals d’une position donnée ? Grâce à l’identifiant de position. Selon la documentation, POSITION_IDENTIFIER est attribué à chaque position nouvellement ouverte, reste identique pendant toute sa vie et correspond au ticket de l’ordre qui l’a ouverte. Les ordres (ORDER_POSITION_ID) et les deals (DEAL_POSITION_ID) portent ce même identifiant.
Deux précisions de la documentation méritent d’être retenues :
- pour une position nouvellement ouverte, le ticket de position correspond au ticket de l’ordre qui a généré le deal ; on peut donc utiliser
result.orderrenvoyé parOrderSendpour sélectionner la position avecPositionSelectByTicket; - en netting, lors d’un retournement,
POSITION_IDENTIFIERne change pas, maisPOSITION_TICKETest remplacé par le ticket de l’ordre qui a provoqué le retournement.
En pratique, pour suivre une position dans le temps, mémorisez son identifiant plutôt que son ticket si votre EA tourne sur un compte netting.
Exemple : suivre la chaîne ordre → deal → position
Le script suivant ouvre une petite position d’achat sur le symbole du graphique, puis affiche l’ordre, le deal et la position correspondants. Utilisez-le uniquement sur un compte de démonstration.
//+------------------------------------------------------------------+
//| Script : afficher la chaîne ordre -> deal -> position |
//| À exécuter sur un compte de DÉMONSTRATION uniquement |
//+------------------------------------------------------------------+
#include <Trade\Trade.mqh>
void OnStart()
{
CTrade trade;
double volume = SymbolInfoDouble(_Symbol, SYMBOL_VOLUME_MIN);
//--- envoi d'un achat au marché (prix 0 = Ask courant)
if(!trade.Buy(volume, _Symbol))
{
Print("Échec de la vérification de base, erreur ", GetLastError());
return;
}
if(trade.ResultRetcode() != TRADE_RETCODE_DONE)
{
Print("Requête non exécutée : ", trade.ResultRetcode(), " ", trade.ResultRetcodeDescription());
return;
}
ulong order_ticket = trade.ResultOrder(); // ticket de l'ordre
ulong deal_ticket = trade.ResultDeal(); // ticket du deal
PrintFormat("Ordre %I64u -> deal %I64u", order_ticket, deal_ticket);
//--- le ticket de la nouvelle position est celui de l'ordre
if(PositionSelectByTicket(order_ticket))
{
PrintFormat("Position %I64u : identifiant %I64d, prix moyen %.5f, volume %.2f",
PositionGetInteger(POSITION_TICKET),
PositionGetInteger(POSITION_IDENTIFIER),
PositionGetDouble(POSITION_PRICE_OPEN),
PositionGetDouble(POSITION_VOLUME));
}
//--- le deal se lit dans l'historique
if(HistorySelect(TimeCurrent() - 3600, TimeCurrent() + 60) && HistoryDealSelect(deal_ticket))
{
PrintFormat("Deal %I64u : entrée %d, prix %.5f, position %I64d",
deal_ticket,
(int)HistoryDealGetInteger(deal_ticket, DEAL_ENTRY),
HistoryDealGetDouble(deal_ticket, DEAL_PRICE),
HistoryDealGetInteger(deal_ticket, DEAL_POSITION_ID));
}
}
Sur un compte netting où une position existait déjà sur le symbole, l’achat s’ajoute à cette position : PositionSelectByTicket(order_ticket) échoue alors, car la position conserve son propre ticket. Utilisez dans ce cas PositionSelect(_Symbol). Cette différence illustre bien pourquoi le mode de compte compte autant que le modèle lui-même.
Les quatre familles de fonctions
La documentation regroupe les fonctions de trading selon l’objet manipulé :
| Objet | Comptage | Sélection | Lecture des propriétés |
|---|---|---|---|
| Ordres actifs | OrdersTotal | OrderGetTicket, OrderSelect | OrderGetInteger, OrderGetDouble, OrderGetString |
| Positions | PositionsTotal | PositionGetTicket, PositionSelect, PositionSelectByTicket | PositionGetInteger, PositionGetDouble, PositionGetString |
| Ordres historiques | HistoryOrdersTotal | HistoryOrderGetTicket, HistoryOrderSelect | HistoryOrderGetInteger… |
| Deals historiques | HistoryDealsTotal | HistoryDealGetTicket, HistoryDealSelect | HistoryDealGetInteger… |
Les deux familles historiques exigent un appel préalable à HistorySelect ou HistorySelectByPosition, qui charge une période d’historique dans le programme. La lecture de l’historique est traitée en détail dans la page Lire l’historique des ordres et transactions.
Autre point commun : les fonctions de sélection copient les données dans l’environnement du programme. La documentation précise que ces données peuvent être périmées si l’objet a changé depuis la sélection ; il faut donc sélectionner juste avant de lire.
Cas d’usage et pièges fréquents
Savoir si l’EA est en position. Interrogez les positions (PositionsTotal puis filtre par symbole et magic number), jamais les ordres actifs. La méthode est détaillée dans Parcourir et filtrer les positions.
Savoir si un ordre en attente a été déclenché. L’ordre disparaît de la liste des ordres actifs et apparaît dans l’historique avec l’état ORDER_STATE_FILLED ; un deal DEAL_ENTRY_IN et une position apparaissent en même temps.
Calculer le résultat d’un trade fermé. Additionnez profit, commission, swap et frais des deals de la position, et non le profit de l’ordre, qui n’a pas de propriété de profit.
Confondre retcode et exécution. Un ordre au marché accepté par le serveur ne garantit pas que les événements d’exécution soient déjà arrivés au terminal au moment où OrderSend rend la main. La documentation le rappelle : la réussite de OrderSend pour un ordre au marché signifie que l’ordre a été placé dans le système de trading pour exécution. Pour réagir à l’exécution elle-même, utilisez OnTradeTransaction.
Migrer depuis MQL4. En MQL4, une position ouverte restait un « ordre » sélectionnable avec OrderSelect. En MQL5, cette logique doit être répartie entre positions et historique. La page Des ordres MQL4 aux positions MQL5 détaille la conversion.
FAQ
Pourquoi OrdersTotal renvoie-t-il 0 alors que j’ai une position ouverte ?
Parce que OrdersTotal ne compte que les ordres actifs, c’est-à-dire les ordres en attente non encore exécutés. Une position ouverte se compte avec PositionsTotal.
Le ticket d’une position est-il égal au ticket de l’ordre qui l’a ouverte ?
Pour une position nouvellement ouverte, oui, selon la documentation de PositionSelectByTicket. En netting, un retournement remplace le ticket de position par celui de l’ordre de retournement, alors que POSITION_IDENTIFIER reste constant.
Où trouver le prix réel d’exécution d’un ordre ?
Dans le deal correspondant (DEAL_PRICE), ou immédiatement après l’envoi dans le champ price de MqlTradeResult (méthode ResultPrice de CTrade). Le prix moyen de la position est dans POSITION_PRICE_OPEN.
Un ordre peut-il produire plusieurs deals ?
Oui. Un ordre partiellement exécuté en plusieurs fois génère un deal par exécution, tous reliés au même ordre par DEAL_ORDER et à la même position par DEAL_POSITION_ID.
- 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
- OnTradeTransaction : réagir aux événements de trading
- Modes de remplissage (FOK, IOC, Return)
- Gérer spread et slippage dans un EA
- Calculer et normaliser la taille de lot
