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

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.

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

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

ObjetPropriétéLecture
Requêtechamp magic de MqlTradeRequestdéfini par l’EA
Ordre actifORDER_MAGICOrderGetInteger
Ordre historiqueORDER_MAGICHistoryOrderGetInteger
DealDEAL_MAGICHistoryDealGetInteger
PositionPOSITION_MAGICPositionGetInteger

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 :

  1. Une base par EA. Attribuez à chaque EA une base distincte, par exemple 2405 suivi de deux chiffres.
  2. 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 input pour que l’utilisateur le choisisse.
  3. 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.
  4. 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 :

  1. L’afficher au démarrage. Un Print dans OnInit, 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.
  2. L’afficher sur le graphique. Un Comment indiquant le nom de la stratégie et son magic number évite de confondre deux graphiques du même symbole.
  3. Le reporter dans le commentaire des ordres. Ajouter un court identifiant de stratégie dans le champ comment aide à 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.

Un magic number en double peut amener un EA à gérer des positions qui ne sont pas les siennes. Le trading avec effet de levier comporte un risque élevé de perte en capital ; vérifiez l’unicité des valeurs sur chaque compte.

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.

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.