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

MQL5 · Ordres et positions

Lire l’historique en MQL5 : HistorySelect, deals et résultat réel des positions

HistorySelect, HistorySelectByPosition et les propriétés des deals : comment lire l’historique de trading en MQL5 pour calculer un bilan journalier ou le résultat réel d’une position.

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

Pour lire l’historique de trading en MQL5, appelez d’abord HistorySelect(debut, fin), qui charge dans le programme la liste des ordres et des deals de la période (en heure du serveur). Parcourez ensuite les deals avec HistoryDealsTotal() et HistoryDealGetTicket(i), puis lisez leurs propriétés avec HistoryDealGetInteger, HistoryDealGetDouble et HistoryDealGetString. Pour reconstituer une seule position, HistorySelectByPosition(identifiant) charge uniquement ses ordres et ses deals.

L’historique est la source de vérité sur ce qui s’est réellement passé : prix d’exécution, commissions, swaps, résultat de chaque sortie. Cette page fait partie de la rubrique Ordres et positions en MQL5 et suppose connue la distinction entre ordres, deals et positions décrite dans Ordres, positions et transactions.

Charger l’historique

HistorySelect

bool HistorySelect(datetime from_date, datetime to_date) récupère l’historique des deals et des ordres pour la période indiquée, en heure du serveur. La documentation précise qu’elle crée dans le programme une liste d’ordres et une liste de deals, dont les tailles se lisent avec HistoryOrdersTotal() et HistoryDealsTotal(). Elle renvoie true en cas de succès.

Pour tout l’historique du compte, l’exemple officiel utilise HistorySelect(0, TimeCurrent()). Pour la journée en cours, passez le début du jour comme borne inférieure. Plus la période est longue, plus la liste est volumineuse : sur un compte ancien et actif, chargez seulement ce dont vous avez besoin.

HistorySelectByPosition

bool HistorySelectByPosition(ulong position_id) construit la liste des ordres et des deals qui portent l’identifiant de position indiqué, c’est-à-dire la valeur de POSITION_IDENTIFIER. C’est la méthode la plus directe pour calculer le résultat complet d’une position, entrées et sorties partielles comprises.

Attention aux sélections unitaires

HistoryDealSelect(ticket) et HistoryOrderSelect(ticket) sélectionnent un élément précis. La documentation avertit qu’elles réinitialisent la liste correspondante et la remplissent avec le seul élément trouvé. Si vous les appelez au milieu d’une boucle sur une liste chargée par HistorySelect, la liste est remplacée et la boucle ne voit plus les autres éléments. Dans une boucle, utilisez les tickets obtenus par HistoryDealGetTicket(i) et lisez directement les propriétés avec ce ticket.

Les propriétés d’un deal

PropriétéTypeContenu
DEAL_TIME, DEAL_TIME_MSCentierheure d’exécution
DEAL_TYPEentierDEAL_TYPE_BUY, DEAL_TYPE_SELL, DEAL_TYPE_BALANCE, DEAL_TYPE_CREDIT, DEAL_TYPE_CHARGE…
DEAL_ENTRYentierDEAL_ENTRY_IN, DEAL_ENTRY_OUT, DEAL_ENTRY_INOUT, DEAL_ENTRY_OUT_BY
DEAL_MAGICentiermagic number de l’ordre d’origine
DEAL_REASONentierorigine : DEAL_REASON_CLIENT, DEAL_REASON_EXPERT, DEAL_REASON_SL, DEAL_REASON_TP, DEAL_REASON_SO…
DEAL_ORDER, DEAL_POSITION_IDentierordre d’origine et identifiant de position
DEAL_VOLUME, DEAL_PRICEdoublevolume et prix d’exécution
DEAL_PROFIT, DEAL_COMMISSION, DEAL_SWAP, DEAL_FEEdoublecomposantes financières
DEAL_SYMBOL, DEAL_COMMENTchaînesymbole et commentaire

La propriété DEAL_REASON est précieuse pour l’analyse : elle indique si une sortie a été provoquée par l’EA, par un stop loss (DEAL_REASON_SL), un take profit (DEAL_REASON_TP) ou un stop out (DEAL_REASON_SO).

Exemple : bilan du jour et détail d’une position

Le script suivant calcule le résultat net réalisé aujourd’hui par un magic number donné, compte les sorties par stop et par objectif, puis détaille la dernière position fermée.

//+------------------------------------------------------------------+
//| Script : bilan journalier et détail d'une position               |
//+------------------------------------------------------------------+
input ulong InpMagic = 240514;    // magic number à analyser

void OnStart()
  {
   //--- début de la journée en heure du serveur
   MqlDateTime dt;
   TimeToStruct(TimeCurrent(), dt);
   dt.hour = 0; dt.min = 0; dt.sec = 0;
   datetime day_start = StructToTime(dt);

   if(!HistorySelect(day_start, TimeCurrent()))
     {
      Print("HistorySelect a échoué, erreur ", GetLastError());
      return;
     }

   double net = 0.0;
   int    exits = 0, by_sl = 0, by_tp = 0;
   ulong  last_pos_id = 0;
   int    total = HistoryDealsTotal();

   for(int i = 0; i < total; i++)
     {
      ulong deal = HistoryDealGetTicket(i);
      if(deal == 0) continue;
      if((ulong)HistoryDealGetInteger(deal, DEAL_MAGIC) != InpMagic) continue;

      long type = HistoryDealGetInteger(deal, DEAL_TYPE);
      if(type != DEAL_TYPE_BUY && type != DEAL_TYPE_SELL) continue;   // ignore dépôts, frais…

      //--- toutes les composantes financières, entrées comprises (commission)
      net += HistoryDealGetDouble(deal, DEAL_PROFIT)
           + HistoryDealGetDouble(deal, DEAL_COMMISSION)
           + HistoryDealGetDouble(deal, DEAL_SWAP)
           + HistoryDealGetDouble(deal, DEAL_FEE);

      long entry = HistoryDealGetInteger(deal, DEAL_ENTRY);
      if(entry == DEAL_ENTRY_OUT || entry == DEAL_ENTRY_OUT_BY)
        {
         exits++;
         long reason = HistoryDealGetInteger(deal, DEAL_REASON);
         if(reason == DEAL_REASON_SL) by_sl++;
         if(reason == DEAL_REASON_TP) by_tp++;
         last_pos_id = (ulong)HistoryDealGetInteger(deal, DEAL_POSITION_ID);
        }
     }
   PrintFormat("Aujourd'hui : %d sorties (%d SL, %d TP), résultat net %.2f %s",
               exits, by_sl, by_tp, net, AccountInfoString(ACCOUNT_CURRENCY));

   if(last_pos_id == 0) return;

   //--- détail de la dernière position fermée (cette sélection remplace la liste)
   if(!HistorySelectByPosition(last_pos_id)) return;
   for(int i = 0; i < HistoryDealsTotal(); i++)
     {
      ulong deal = HistoryDealGetTicket(i);
      if(deal == 0) continue;
      PrintFormat("Position %I64u | deal %I64u | entrée %d | %.2f lot à %.5f | profit %.2f",
                  last_pos_id, deal,
                  (int)HistoryDealGetInteger(deal, DEAL_ENTRY),
                  HistoryDealGetDouble(deal, DEAL_VOLUME),
                  HistoryDealGetDouble(deal, DEAL_PRICE),
                  HistoryDealGetDouble(deal, DEAL_PROFIT));
     }
  }

Deux détails méritent l’attention. D’abord, le filtre sur DEAL_TYPE exclut les opérations de solde, de crédit et de frais, qui sont aussi des deals. Ensuite, selon le broker, la commission peut être enregistrée sur le deal d’entrée : additionner seulement les deals de sortie risquerait alors de sous-estimer les coûts.

Passer des deals aux trades

Pour une analyse de stratégie, l’unité utile n’est pas le deal mais le trade, c’est-à-dire la position de son ouverture à sa fermeture complète. Le regroupement se fait par DEAL_POSITION_ID : tous les deals qui portent le même identifiant appartiennent à la même position. Une position est terminée lorsque la somme des volumes d’entrée (DEAL_ENTRY_IN) est égale à la somme des volumes de sortie (DEAL_ENTRY_OUT et DEAL_ENTRY_OUT_BY).

Concrètement, une méthode simple consiste à parcourir les deals de la période, à collecter les identifiants de position distincts dans un tableau, puis à appeler HistorySelectByPosition pour chacun afin d’en calculer le résultat net, la durée (écart entre le premier et le dernier DEAL_TIME) et le motif de sortie. Comme cet appel remplace la liste chargée, collectez d’abord tous les identifiants, puis traitez-les dans une seconde boucle.

En netting, gardez à l’esprit qu’un retournement (DEAL_ENTRY_INOUT) ferme une position et en ouvre une autre de sens opposé dans un seul deal, avec le même identifiant : votre découpage en trades doit traiter ce cas à part si votre stratégie retourne ses positions.

L’historique des ordres

Les ordres historiques se lisent selon le même schéma avec HistoryOrdersTotal(), HistoryOrderGetTicket(i) et HistoryOrderGetInteger/Double/String. Ils contiennent les ordres exécutés, mais aussi les ordres annulés, rejetés ou expirés, que l’on reconnaît à leur état ORDER_STATE. C’est la seule trace d’un ordre en attente qui a expiré sans être déclenché : utile pour mesurer, par exemple, le taux de déclenchement d’une stratégie de cassure.

La documentation rappelle de ne pas confondre ces ordres historiques avec les ordres en attente actifs, que l’on parcourt avec OrdersTotal().

Cas d’usage en trading

Limite de perte journalière. Le résultat réalisé du jour, ajouté au flottant des positions ouvertes, permet de couper l’EA quand une limite est atteinte. La logique complète est présentée dans Limite de perte journalière.

Statistiques par stratégie. Grouper les deals par magic number et par identifiant de position permet de calculer nombre de trades, gain moyen, perte moyenne et espérance mathématique de chaque stratégie en conditions réelles, et de les comparer au backtest.

Mesure de la qualité d’exécution. Le prix de chaque deal comparé au prix demandé ou au niveau du stop mesure le glissement réel ; voir Gérer spread et slippage dans un EA.

Délai entre événement et lecture. Un deal exécuté peut ne pas encore figurer dans la liste chargée quelques instants plus tôt. Rechargez l’historique (nouvel appel à HistorySelect) avant chaque calcul, et pour une réaction immédiate à un nouveau deal, utilisez OnTradeTransaction.

Pièges fréquents

Oublier HistorySelect. Sans chargement préalable, HistoryDealsTotal() renvoie 0 ou une liste obsolète. La documentation de HistoryDealGetTicket indique explicitement qu’il faut d’abord recevoir l’historique.

Heure locale contre heure serveur. Les bornes de HistorySelect sont en heure du serveur. Calculer le début de journée avec l’heure locale de votre ordinateur décale le bilan quotidien.

Additionner seulement DEAL_PROFIT. Le résultat réel inclut commission, swap et frais.

Réinitialiser la liste en cours de boucle. Un appel à HistoryDealSelect ou HistorySelectByPosition à l’intérieur d’une boucle remplace la liste parcourue.

L’historique décrit le passé : un bon résultat récent ne préjuge pas des résultats futurs. Le trading avec effet de levier comporte un risque élevé de perte en capital.

FAQ

Pourquoi HistoryDealsTotal renvoie-t-il 0 ?

Parce que l’historique n’a pas été chargé, ou que la période passée à HistorySelect ne contient aucun deal. Appelez HistorySelect avec des bornes en heure du serveur juste avant la lecture.

Comment calculer le profit net d’une position fermée ?

Chargez ses deals avec HistorySelectByPosition(identifiant) et additionnez DEAL_PROFIT, DEAL_COMMISSION, DEAL_SWAP et DEAL_FEE de tous ses deals, entrées comprises.

Comment savoir si une position a été fermée par son stop loss ?

Lisez DEAL_REASON du deal de sortie : la valeur DEAL_REASON_SL indique une sortie par stop loss, DEAL_REASON_TP par take profit.

Faut-il recharger l’historique à chaque tick ?

Seulement si vous en avez besoin à chaque tick. Pour un bilan, rechargez juste avant le calcul ; pour réagir aux nouveaux deals, préférez OnTradeTransaction.

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.