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

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.

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

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 :

ValeurSignification
DEAL_ENTRY_INouverture ou augmentation d’une position
DEAL_ENTRY_OUTsortie (totale ou partielle) d’une position
DEAL_ENTRY_INOUTretournement de la position (netting)
DEAL_ENTRY_OUT_BYfermeture 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.order renvoyé par OrderSend pour sélectionner la position avec PositionSelectByTicket ;
  • en netting, lors d’un retournement, POSITION_IDENTIFIER ne change pas, mais POSITION_TICKET est 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é :

ObjetComptageSélectionLecture des propriétés
Ordres actifsOrdersTotalOrderGetTicket, OrderSelectOrderGetInteger, OrderGetDouble, OrderGetString
PositionsPositionsTotalPositionGetTicket, PositionSelect, PositionSelectByTicketPositionGetInteger, PositionGetDouble, PositionGetString
Ordres historiquesHistoryOrdersTotalHistoryOrderGetTicket, HistoryOrderSelectHistoryOrderGetInteger…
Deals historiquesHistoryDealsTotalHistoryDealGetTicket, HistoryDealSelectHistoryDealGetInteger…

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.

Les exemples de cette page envoient de vrais ordres au serveur. Exécutez-les sur un compte de démonstration : sur un compte réel, toute position ouverte expose votre capital au risque de perte.

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.

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.