MQL5 · Ordres et positions
Ordres et positions en MQL5 : passer, gérer et suivre ses trades
Tout ce qu’un Expert Advisor doit maîtriser pour trader en MQL5 : modèle ordres, transactions et positions, CTrade, OrderSend, stops, clôture, historique et codes de retour.
Passer un ordre en MQL5 tient en une ligne de code. Le faire correctement, sur un compte réel, chez n’importe quel broker, en est une autre. Cette rubrique réunit tout ce qu’un Expert Advisor doit savoir faire avec le serveur de trading de MetaTrader 5 : comprendre le modèle ordres / transactions / positions, envoyer une requête avec CTrade ou OrderSend, la vérifier avant l’envoi, placer et déplacer les stops, fermer, retrouver ses positions, lire l’historique et réagir aux événements de trading.
La réponse courte à la question « comment un EA trade-t-il en MQL5 ? » est la suivante : le programme construit une requête (structure MqlTradeRequest), l’envoie au serveur, puis lit la réponse (structure MqlTradeResult) et en particulier son champ retcode. Un ordre accepté produit une ou plusieurs transactions (deals), qui ouvrent, modifient ou ferment une position. Tout le reste de la rubrique décline ce schéma.
Pourquoi une rubrique entière sur les ordres
En MQL4, un ordre exécuté restait un « ordre » que l’on manipulait avec OrderSelect. MetaTrader 5 a séparé trois objets distincts et ajouté deux modes de comptabilité des positions (netting et hedging). Beaucoup de bugs d’Expert Advisors viennent de cette confusion : un EA qui compte les ordres au lieu des positions, qui oublie le ticket de position sur un compte hedging, ou qui considère qu’un true renvoyé par OrderSend signifie que l’ordre est exécuté.
La documentation officielle est explicite sur ce dernier point : pour OrderSend comme pour chaque méthode de CTrade, une valeur true indique seulement que la vérification de base des structures a réussi, pas que l’opération de trading a été exécutée. Il faut toujours lire le code de retour du serveur. C’est le fil conducteur de toutes les pages qui suivent.
Ordre de lecture conseillé
Les 18 pages sont classées dans un ordre progressif. Vous pouvez les lire dans l’ordre ou piocher selon votre besoin, mais les quatre premières sont un prérequis pour toutes les autres.
1. Comprendre le modèle de MetaTrader 5
- Ordres, positions et transactions : le modèle de MT5 : la différence entre un ordre (une demande), une transaction ou deal (une exécution) et une position (le résultat net), et le rôle de l’identifiant de position qui relie les trois.
- Comptes netting ou hedging : comment détecter le mode du compte avec
ACCOUNT_MARGIN_MODEet ce qui change pour le code (une ou plusieurs positions par symbole, retournement, fermeture par position opposée).
2. Envoyer une requête au serveur
- La classe CTrade : la classe de la bibliothèque standard qui simplifie l’envoi des requêtes, ses réglages (magic number, déviation, mode de remplissage) et la lecture des résultats.
- OrderSend et MqlTradeRequest : la fonction native, les champs obligatoires selon le type d’action et la lecture de
MqlTradeResult. - OrderCheck : vérifier un ordre avant envoi : contrôler la marge et la validité d’une requête sans l’envoyer.
3. Ouvrir et gérer une position
- Ouvrir une position au marché : achat et vente immédiats, calcul des stops au bon prix (Ask ou Bid), gestion des codes de retour.
- Ordres limites et stop : les six types d’ordres en attente, leur expiration, leur modification et leur suppression.
- Placer et modifier stop loss et take profit : à l’ouverture ou après, avec la contrainte de distance minimale
SYMBOL_TRADE_STOPS_LEVEL. - Coder un trailing stop : suivre le prix sans saturer le serveur de requêtes.
- Passer une position à break-even : remonter le stop au prix d’entrée, avec ou sans marge de sécurité.
- Fermer une position (totale ou partielle) :
PositionClose,PositionClosePartial, fermeture par position opposée.
4. Retrouver et suivre ses opérations
- Parcourir et filtrer les positions : boucles sur
PositionsTotaletOrdersTotal, filtres par symbole et par magic number. - Le magic number : identifier les opérations d’un EA, choisir et documenter ses valeurs.
- Lire l’historique des ordres et transactions :
HistorySelect,HistorySelectByPositionet le calcul du résultat réel d’une position. - OnTradeTransaction : réagir aux événements de trading : le gestionnaire d’événements qui signale chaque ajout d’ordre, de deal ou de modification.
5. S’adapter aux conditions d’exécution
- Modes de remplissage (FOK, IOC, Return) : choisir le bon
ENUM_ORDER_TYPE_FILLINGselon le symbole pour éviter l’erreur 10030. - Gérer spread et slippage dans un EA : filtrer les spreads anormaux, paramétrer la déviation et mesurer le glissement réel.
- Calculer et normaliser la taille de lot : convertir un risque en argent en volume valide (minimum, maximum, pas).
Les briques communes à toutes les pages
Quel que soit le sujet, vous retrouverez les mêmes réflexes dans les exemples de code de la rubrique :
- Lire les propriétés du symbole au lieu de les supposer : nombre de décimales, taille du tick, volume minimal et pas de volume, distance minimale des stops, modes de remplissage autorisés.
- Normaliser les prix et les volumes avant l’envoi. Un prix doit respecter la précision du symbole, un volume doit être un multiple du pas autorisé.
- Identifier ses opérations par un magic number et, sur un compte hedging, par le ticket de position.
- Lire systématiquement le code de retour (
retcode) et réagir selon sa nature : succès (10009 « Request completed », 10008 « Order placed »), erreur de paramètre à corriger, ou condition de marché temporaire. - Journaliser chaque requête refusée avec son code et son commentaire, pour pouvoir diagnostiquer après coup.
Les codes de retour eux-mêmes sont détaillés dans une rubrique dédiée : Codes de retour du serveur de trading. Chaque code fréquent (10004, 10006, 10013 à 10019, 10030…) y dispose de sa propre page de diagnostic.
Comment cette rubrique s’articule avec le reste du silo MQL5
Les pages de cette rubrique traitent de la mécanique des ordres. La logique de décision (quand entrer, quand sortir) relève de la rubrique Construire un Expert Advisor, qui montre comment assembler signal, filtres et gestion du risque. Le comportement de vos ordres en backtest (délais, ticks réels, slippage simulé) est traité dans la rubrique Strategy Tester et optimisation.
Pour la partie purement financière, c’est-à-dire combien risquer par trade et pourquoi, reportez-vous à la page Calculer la taille de position du silo gestion du risque ; la page taille de lot de cette rubrique se concentre sur la traduction de ce risque en code.
Ce que vous saurez faire à la fin de la rubrique
À l’issue de ces 18 pages, vous serez capable d’écrire un module de trading complet pour vos EA : une fonction d’ouverture qui calcule le volume selon le risque et choisit le mode de remplissage adapté au symbole, des fonctions de gestion (trailing stop, break-even, clôture partielle) qui ne touchent qu’aux positions de l’EA, une lecture fiable de l’historique pour calculer la performance du jour, et un gestionnaire OnTradeTransaction pour réagir immédiatement à une exécution. Vous saurez surtout distinguer une requête acceptée d’une opération réellement exécutée, ce qui évite la majorité des comportements inattendus en production.
FAQ
Faut-il utiliser CTrade ou OrderSend ?
Les deux envoient la même requête au serveur. CTrade remplit les structures pour vous et offre des méthodes lisibles (Buy, PositionClose, PositionModify), ce qui suffit pour la grande majorité des EA. OrderSend donne un contrôle champ par champ et sert à comprendre ce que fait la classe. Les deux sont présentés dans cette rubrique.
Pourquoi mon EA ouvre-t-il des positions sur un compte démo mais pas sur un compte réel ?
Les causes les plus fréquentes sont un mode de remplissage non supporté par le symbole (code 10030), un volume hors des bornes du symbole (10014), des stops trop proches (10016) ou le trading automatique désactivé (10027). Lisez le retcode renvoyé et consultez les pages filling modes, taille de lot et stop loss de cette rubrique.
Dans quel ordre lire ces pages si je débute ?
Lisez d’abord le modèle ordres / positions / transactions, puis netting ou hedging, puis la classe CTrade et l’ouverture au marché. Vous aurez alors de quoi écrire un premier EA fonctionnel ; les autres pages se lisent ensuite selon vos besoins.
Ces pages s’appliquent-elles au Strategy Tester ?
Oui, le même code envoie les ordres en backtest et en réel. Les conditions d’exécution diffèrent cependant (délais, slippage, spread), c’est pourquoi les pages pratiques signalent les pièges à vérifier en réel.
- 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
- 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
