MQL4 · Ordres
Historique des ordres en MQL4 : MODE_HISTORY et OrdersHistoryTotal
Parcourir MODE_HISTORY, calculer le résultat du jour, retrouver le dernier trade d’un EA et éviter le piège du filtre de l’onglet Historique du compte dans MetaTrader 4.
En MQL4, l’historique des ordres contient les positions fermées et les ordres en attente supprimés. On le parcourt avec OrdersHistoryTotal(), qui renvoie le nombre d’ordres chargés dans l’historique du terminal, et OrderSelect(i, SELECT_BY_POS, MODE_HISTORY). Une fois un ordre sélectionné, OrderCloseTime(), OrderClosePrice(), OrderProfit(), OrderSwap() et OrderCommission() donnent son résultat. Point capital : la taille de cette liste dépend du réglage de l’onglet Historique du compte du terminal, qui peut n’afficher qu’une période limitée.
Cette page montre comment parcourir l’historique, calculer un résultat journalier, retrouver le dernier trade d’un EA et éviter les pièges liés au filtre du terminal. Elle fait partie de la rubrique Gérer les ordres en MQL4.
Ce que contient l’historique
Le pool MODE_HISTORY regroupe :
- les positions fermées, par leur stop, leur objectif, l’EA ou l’utilisateur ;
- les ordres en attente supprimés ou expirés, qui n’ont jamais été exécutés ;
- les opérations sur le solde (dépôts, retraits, crédits), qui apparaissent aussi dans l’onglet Historique du compte.
Un EA qui calcule ses statistiques doit donc filtrer : par symbole, par numéro magique et par type, pour ne retenir que les positions fermées (OrderType() égal à OP_BUY ou OP_SELL). Les opérations sur le solde n’ont pas de numéro magique d’EA, et le filtre sur le magic suffit en pratique à les exclure ; le filtre sur le symbole renforce cette protection.
Le piège de l’onglet Historique du compte
OrdersHistoryTotal() ne renvoie pas forcément tout l’historique du compte : il renvoie les ordres chargés dans le terminal, et ce chargement suit le filtre de période choisi dans l’onglet Historique du compte (clic droit, par exemple « Mois dernier », « 3 derniers mois », « Tout l’historique »). Si l’utilisateur a choisi une période courte, un EA qui calcule son profit total depuis le début sous-estimera le résultat sans aucun message d’erreur.
Les conséquences pratiques sont simples :
- pour un calcul du jour ou de la semaine, le réglage par défaut suffit en général ;
- pour un calcul depuis le lancement de l’EA, demandez à l’utilisateur de sélectionner « Tout l’historique », ou mieux, stockez vous-même les résultats au fil de l’eau dans un fichier ou une variable globale du terminal ;
- dans le testeur de stratégie, l’historique contient les ordres du test en cours.
Exemple : résultat du jour et dernier trade
#property strict
input int InpMagic = 240213; // Numéro magique
input double InpPerteMaxJour = 2.0; // Perte journalière max (% du solde)
//+------------------------------------------------------------------+
//| Début de la journée serveur courante |
//+------------------------------------------------------------------+
datetime DebutJournee()
{
MqlDateTime dt;
TimeToStruct(TimeCurrent(), dt);
dt.hour = 0; dt.min = 0; dt.sec = 0;
return(StructToTime(dt));
}
//+------------------------------------------------------------------+
//| Résultat net des positions de l'EA fermées depuis 'depuis' |
//+------------------------------------------------------------------+
double ResultatFerme(datetime depuis)
{
double total = 0.0;
for(int i = OrdersHistoryTotal() - 1; i >= 0; i--)
{
if(!OrderSelect(i, SELECT_BY_POS, MODE_HISTORY)) continue;
if(OrderSymbol() != Symbol() || OrderMagicNumber() != InpMagic) continue;
if(OrderType() > OP_SELL) continue; // ordres en attente supprimés
if(OrderCloseTime() < depuis) continue; // fermé avant la période
total += OrderProfit() + OrderSwap() + OrderCommission();
}
return(total);
}
//+------------------------------------------------------------------+
//| Ticket du dernier trade fermé de l'EA, ou -1 |
//+------------------------------------------------------------------+
int DernierTradeFerme()
{
int ticket = -1;
datetime plusRecent = 0;
for(int i = OrdersHistoryTotal() - 1; i >= 0; i--)
{
if(!OrderSelect(i, SELECT_BY_POS, MODE_HISTORY)) continue;
if(OrderSymbol() != Symbol() || OrderMagicNumber() != InpMagic) continue;
if(OrderType() > OP_SELL) continue;
if(OrderCloseTime() > plusRecent) // on compare explicitement les dates
{
plusRecent = OrderCloseTime();
ticket = OrderTicket();
}
}
return(ticket);
}
void OnTick()
{
double resultatJour = ResultatFerme(DebutJournee());
double limite = -AccountBalance() * InpPerteMaxJour / 100.0;
if(resultatJour <= limite)
{
Comment("Limite de perte journalière atteinte : pas de nouvelle entrée");
return;
}
int dernier = DernierTradeFerme();
if(dernier > 0 && OrderSelect(dernier, SELECT_BY_TICKET))
Comment("Résultat du jour : ", DoubleToString(resultatJour, 2),
"\nDernier trade : ", DoubleToString(OrderProfit(), 2),
" fermé le ", TimeToString(OrderCloseTime()));
}
Plusieurs choix méritent explication. Le résultat additionne profit, swap et commission : OrderProfit() seul ignore les frais et surestime le gain. Le dernier trade est trouvé en comparant les dates de clôture, sans supposer que la liste est triée chronologiquement. La journée est calculée en heure du serveur, comme toutes les dates d’ordres (voir Fonctions de temps). Enfin, la limite de perte journalière est un cas d’usage typique de l’historique : elle combine les positions fermées du jour et pourrait aussi intégrer les pertes latentes des positions ouvertes, calculées comme dans OrderSelect et boucles.
Autres usages de l’historique
- Pause après une série de pertes : compter les derniers trades perdants consécutifs et suspendre les entrées au-delà d’un seuil.
- Une seule entrée par bougie ou par jour : vérifier dans l’historique qu’aucun trade n’a été ouvert sur la bougie courante, y compris s’il a déjà été fermé.
- Statistiques en direct : taux de réussite, gain moyen et perte moyenne affichés sur le graphique.
- Analyse a posteriori : exporter l’historique dans un fichier CSV pour l’étudier dans un tableur.
Pour l’analyse de la performance d’une stratégie, le rapport du testeur ou du compte reste plus complet ; l’historique lu par l’EA sert surtout à prendre des décisions en temps réel.
Retrouver un ordre précis par son ticket
Si l’EA connaît le ticket d’un ordre, OrderSelect(ticket, SELECT_BY_TICKET) le trouve, qu’il soit ouvert ou fermé, puisque le pool est ignoré dans ce mode. OrderCloseTime() permet ensuite de savoir s’il est dans l’historique : une valeur non nulle signifie qu’il est fermé ou supprimé. C’est la façon de vérifier, après un événement inattendu, si une position a été fermée par son stop.
Mettre le résultat en cache
Sur un compte qui accumule des milliers d’ordres fermés, parcourir l’historique complet à chaque tick finit par coûter du temps d’exécution. Une technique simple consiste à mémoriser la valeur de OrdersHistoryTotal() dans une variable globale et à ne recalculer les statistiques que lorsque ce nombre change, c’est-à-dire lorsqu’un ordre vient d’être fermé ou supprimé. Entre deux changements, l’EA réutilise le dernier résultat calculé. Réinitialisez aussi le cache au changement de journée si vous calculez un résultat quotidien, puisque la période de référence change même sans nouvel ordre fermé.
Cette optimisation conserve l’exactitude du calcul tout en réduisant le travail à presque rien la plupart du temps. Elle est particulièrement utile dans le testeur de stratégie, où un historique qui grossit au fil du test peut ralentir fortement les longues périodes, et sur les VPS modestes qui font tourner plusieurs terminaux.
Pièges fréquents
- Ne compter que
OrderProfit(): swap et commission sont exclus. - Ignorer le filtre de période du terminal : un historique partiel donne des statistiques fausses sans erreur visible.
- Supposer un ordre chronologique : comparez
OrderCloseTime()ouOrderOpenTime(). - Inclure les ordres en attente supprimés : ils ont un résultat nul et faussent les taux de réussite.
- Parcourir tout l’historique à chaque tick sur un compte très actif : limitez-vous à la période utile ou mettez le résultat en cache, recalculé uniquement quand
OrdersHistoryTotal()change.
- Oublier le changement de journée : un résultat journalier calculé depuis minuit heure serveur ne correspond pas forcément à minuit heure de Paris. Exposez l’heure de début de journée en paramètre si votre règle de gestion en dépend.
Et en MQL5 ?
En MQL5, l’historique doit d’abord être chargé explicitement pour une période avec HistorySelect(debut, fin), ce qui supprime la dépendance au filtre du terminal. On parcourt ensuite les transactions (HistoryDealsTotal(), HistoryDealGetTicket()) ou les ordres historiques (HistoryOrdersTotal()). Le résultat d’un trade se lit sur ses transactions de sortie. Voir Des ordres MQL4 aux positions MQL5.
FAQ
Pourquoi OrdersHistoryTotal renvoie-t-il moins d’ordres que prévu ?
Parce qu’il compte les ordres chargés selon le filtre de période de l’onglet Historique du compte. Sélectionnez « Tout l’historique » par clic droit dans cet onglet pour charger l’ensemble.
Comment calculer le profit du jour d’un EA en MQL4 ?
Parcourez MODE_HISTORY, filtrez par symbole, numéro magique et type, gardez les ordres dont OrderCloseTime() est postérieur au début de la journée serveur, et additionnez OrderProfit(), OrderSwap() et OrderCommission().
Les ordres en attente supprimés sont-ils dans l’historique ?
Oui, ils figurent dans MODE_HISTORY. Filtrez-les avec OrderType() > OP_SELL si vous ne voulez que les positions fermées.
Peut-on retrouver un ordre fermé par son ticket ?
Oui, OrderSelect(ticket, SELECT_BY_TICKET) le trouve dans l’historique s’il y est chargé. OrderCloseTime() non nulle confirme qu’il est fermé.
