MQL5 · Ordres et positions
Le magic number en MQL5 : identifier les opérations de son Expert Advisor
Le magic number signe chaque requête d’un EA et se retrouve sur ordres, deals et positions. Comment le choisir, le régler avec CTrade et filtrer partout pour ne gérer que ses propres trades.
Le magic number est un entier non signé (ulong) que l’Expert Advisor place dans chacune de ses requêtes de trading pour signer ses opérations. MetaTrader 5 le recopie sur l’ordre (ORDER_MAGIC), sur les deals qui en résultent (DEAL_MAGIC) et sur la position (POSITION_MAGIC). En filtrant sur cette valeur, l’EA retrouve ses propres positions, ordres et deals et laisse intactes les opérations manuelles ou celles des autres programmes. Il se règle avec CTrade::SetExpertMagicNumber(magic) ou le champ magic de MqlTradeRequest.
La documentation de MqlTradeRequest décrit ce champ comme l’identifiant de l’Expert Advisor, qui permet d’organiser le traitement analytique des ordres de trading : chaque EA peut définir son propre identifiant unique lors de l’envoi d’une requête. Cette page fait partie de la rubrique Ordres et positions en MQL5.
Pourquoi c’est indispensable
Un compte MetaTrader 5 est partagé par tout ce qui y trade : vous-même depuis le terminal, l’application mobile, et chaque EA attaché à un graphique. Sans signature, un EA ne peut pas savoir quelles positions lui appartiennent. Les conséquences sont concrètes :
- un trailing stop qui modifie les stops d’une position ouverte à la main ;
- une fonction « tout fermer » qui ferme les positions d’un autre EA ;
- un compteur de positions qui empêche l’EA d’entrer parce qu’une autre stratégie est déjà en position ;
- des statistiques de performance qui mélangent plusieurs stratégies.
Le magic number règle ces problèmes, à une condition : que chaque instance d’EA susceptible de trader le même symbole sur le même compte ait une valeur différente, et que toutes les fonctions de l’EA filtrent sur cette valeur.
Où le magic number apparaît
| Objet | Propriété | Lecture |
|---|---|---|
| Requête | champ magic de MqlTradeRequest | défini par l’EA |
| Ordre actif | ORDER_MAGIC | OrderGetInteger |
| Ordre historique | ORDER_MAGIC | HistoryOrderGetInteger |
| Deal | DEAL_MAGIC | HistoryDealGetInteger |
| Position | POSITION_MAGIC | PositionGetInteger |
Avec CTrade, le réglage est fait une fois : SetExpertMagicNumber est appliqué à toutes les requêtes envoyées par l’objet, ouvertures comme modifications et fermetures. Les fonctions de lecture renvoient un long ; comparez-le à votre valeur ulong avec une conversion explicite pour éviter un avertissement de compilation.
Choisir ses valeurs
Il n’existe pas de règle officielle de numérotation. Voici une méthode simple et robuste :
- Une base par EA. Attribuez à chaque EA une base distincte, par exemple 2405 suivi de deux chiffres.
- Une valeur par instance. Si le même EA tourne sur plusieurs symboles ou plusieurs unités de temps, dérivez une valeur différente par instance, ou exposez le magic number en paramètre
inputpour que l’utilisateur le choisisse. - Un registre. Tenez une liste écrite des valeurs utilisées sur chaque compte. C’est le seul moyen fiable d’éviter les collisions quand plusieurs EA tournent ensemble.
- Jamais 0. Les opérations manuelles ont un magic number nul ; utiliser 0 dans un EA le rendrait indiscernable de vos propres trades.
Exposer le magic number en paramètre d’entrée est la solution la plus répandue : l’utilisateur garde la maîtrise des valeurs, et la page Paramètres input et sinput explique comment déclarer proprement ce type de réglage.
Exemple : dériver un magic number par symbole et filtrer partout
Le code suivant calcule un magic number distinct pour chaque symbole à partir d’une base, puis l’utilise de manière cohérente pour les positions, les ordres et l’historique.
//+------------------------------------------------------------------+
//| Magic number dérivé du symbole et filtrage cohérent |
//+------------------------------------------------------------------+
#include <Trade\Trade.mqh>
input ulong InpMagicBase = 24051300; // base propre à cet EA
CTrade trade;
ulong g_magic = 0;
//--- somme pondérée des caractères du symbole (valeur reproductible)
ulong SymbolCode(const string symbol)
{
ulong code = 0;
for(int i = 0; i < StringLen(symbol); i++)
code = (code * 31 + StringGetCharacter(symbol, i)) % 100;
return(code); // 0 à 99
}
int OnInit()
{
g_magic = InpMagicBase + SymbolCode(_Symbol);
trade.SetExpertMagicNumber(g_magic);
PrintFormat("Magic number de cette instance : %I64u", g_magic);
return(INIT_SUCCEEDED);
}
//--- positions de cette instance
int MyPositions()
{
int n = 0;
for(int i = PositionsTotal() - 1; i >= 0; i--)
if(PositionGetTicket(i) > 0 &&
(ulong)PositionGetInteger(POSITION_MAGIC) == g_magic &&
PositionGetString(POSITION_SYMBOL) == _Symbol)
n++;
return(n);
}
//--- résultat réalisé de cette instance depuis une date
double MyRealizedProfit(datetime from)
{
double total = 0.0;
if(!HistorySelect(from, TimeCurrent())) return(0.0);
for(int i = HistoryDealsTotal() - 1; i >= 0; i--)
{
ulong deal = HistoryDealGetTicket(i);
if(deal == 0) continue;
if((ulong)HistoryDealGetInteger(deal, DEAL_MAGIC) != g_magic) continue;
if(HistoryDealGetString(deal, DEAL_SYMBOL) != _Symbol) continue;
total += HistoryDealGetDouble(deal, DEAL_PROFIT)
+ HistoryDealGetDouble(deal, DEAL_COMMISSION)
+ HistoryDealGetDouble(deal, DEAL_SWAP);
}
return(total);
}
void OnTick()
{
// ... utiliser MyPositions() avant d'entrer, MyRealizedProfit() pour les statistiques
}
La dérivation par symbole évite de saisir une valeur à la main pour chaque graphique, mais deux symboles peuvent donner le même code : vérifiez les valeurs affichées au démarrage, ou préférez un paramètre input si vous déployez sur beaucoup de symboles. La lecture de l’historique utilisée dans MyRealizedProfit est détaillée dans Lire l’historique des ordres et transactions.
Magic number et mode du compte
Sur un compte hedging, chaque position conserve le magic number de l’ordre qui l’a ouverte, et deux EA qui tradent le même symbole gardent des positions bien séparées. Sur un compte netting, en revanche, toutes les transactions d’un symbole se fondent dans une seule position, quel que soit leur magic number : deux EA sur le même symbole partagent la même exposition et le filtre par magic number ne suffit plus à isoler leurs résultats. Les deals, eux, gardent chacun leur DEAL_MAGIC, ce qui permet au moins de reconstituer la contribution de chaque EA dans l’historique. Voir Comptes netting ou hedging.
Documenter le magic number dans l’EA
Le magic number est une information d’exploitation autant qu’un détail technique. Trois habitudes facilitent la maintenance d’un parc d’EA :
- L’afficher au démarrage. Un
PrintdansOnInit, comme dans l’exemple, laisse une trace dans le journal à chaque lancement : en cas de doute sur une position, vous retrouvez immédiatement quelle instance l’a ouverte. - L’afficher sur le graphique. Un
Commentindiquant le nom de la stratégie et son magic number évite de confondre deux graphiques du même symbole. - Le reporter dans le commentaire des ordres. Ajouter un court identifiant de stratégie dans le champ
commentaide à la lecture de l’historique dans le terminal, même si le filtrage doit rester fondé sur le magic number.
Quand vous arrêtez une stratégie, ne réutilisez pas immédiatement son magic number pour une autre : les statistiques calculées sur l’historique mélangeraient les deux.
Cas d’usage en trading
Faire tourner plusieurs stratégies sur un compte. Chaque stratégie a son magic number et ses propres limites de positions. Le calcul de performance par stratégie devient possible directement depuis l’historique.
Redémarrage du terminal. Après un redémarrage ou une recompilation, l’EA retrouve ses positions ouvertes grâce au magic number. Une valeur qui changerait d’un lancement à l’autre (par exemple calculée avec l’heure) lui ferait perdre la trace de ses positions.
Filtrer dans le rapport. Dans l’historique du terminal comme dans vos exports, le magic number permet de séparer ce qui vient de l’EA de ce qui vient d’interventions manuelles, utile pour juger honnêtement une stratégie.
Pièges fréquents
Même valeur sur deux graphiques. Deux instances du même EA avec le même magic number sur le même symbole se considèrent mutuellement comme « soi » : chacune voit les positions de l’autre. C’est l’erreur la plus fréquente.
Filtre oublié dans une fonction. Le filtre est souvent présent dans la fonction d’entrée mais absent du trailing ou de la fermeture. Centralisez le test dans une fonction unique, comme IsMine dans la page Parcourir et filtrer les positions.
Comparaison de types. PositionGetInteger renvoie un long, le magic number est un ulong : convertissez explicitement.
FAQ
Le magic number peut-il être modifié après l’ouverture ?
Non : il est attaché à l’ordre et transmis aux deals et à la position. Pour changer de valeur, il faut ouvrir de nouvelles positions avec le nouveau magic number.
Quelle valeur ont les positions ouvertes manuellement ?
Les opérations manuelles n’ont pas de magic number défini par un programme ; leur valeur est 0. C’est pourquoi un EA ne doit jamais utiliser 0.
Le commentaire peut-il remplacer le magic number ?
Ce n’est pas recommandé. Le commentaire est un texte libre que le broker peut modifier ou tronquer ; le magic number est un identifiant numérique prévu pour cet usage.
Faut-il un magic number différent par unité de temps ?
Oui si le même EA tourne sur le même symbole avec plusieurs unités de temps : sinon les instances partagent leurs positions. Une valeur distincte par instance est la règle.
- 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
- 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
