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

MQL4 · Ordres

Magic number en MQL4 : identifier et retrouver les ordres d’un EA

Le magic number attache un identifiant à chaque ordre d’un EA MQL4. Comment le choisir, filtrer avec OrderMagicNumber, faire cohabiter plusieurs EA et éviter de perdre ses positions.

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

Le magic number (numéro magique) est un entier que l’EA attache à chaque ordre qu’il envoie, via le paramètre magic d’OrderSend(). Il se relit ensuite avec OrderMagicNumber() après un OrderSelect(). Son rôle est d’identifier les ordres appartenant à un EA donné : en filtrant sur le symbole et sur ce numéro, un robot ne compte, ne modifie et ne ferme que ses propres ordres, même si d’autres EA ou l’utilisateur tradent sur le même compte. Les ordres passés manuellement ont un numéro magique égal à 0. Le numéro est stocké sur le serveur avec l’ordre, ce qui permet à l’EA de retrouver ses positions après un redémarrage.

Cette page explique comment choisir et gérer un numéro magique, et comment l’utiliser pour faire cohabiter plusieurs stratégies. Elle fait partie de la rubrique Gérer les ordres en MQL4.

Pourquoi le numéro magique est indispensable

Un compte MetaTrader 4 ne sépare pas les ordres par programme : OrdersTotal() renvoie le nombre total d’ordres du compte, tous symboles et toutes origines confondus. Sans numéro magique, un EA ne peut pas savoir quels ordres sont les siens. Les conséquences sont concrètes :

  • il refuse d’ouvrir parce qu’il voit une position ouverte par un autre EA ou à la main ;
  • il ferme ou modifie les ordres d’un autre robot, par exemple en appliquant son trailing stop à des positions qui ne le concernent pas ;
  • il perd la trace de ses positions après un redémarrage, s’il ne les connaissait que par des tickets mémorisés dans des variables.

Le commentaire d’ordre n’est pas une alternative fiable : la documentation d’OrderSend() précise que le serveur peut en modifier la dernière partie, et une clôture partielle le remplace.

Choisir un numéro

Le numéro est un int. Il n’existe pas de règle imposée, mais quelques conventions évitent les collisions :

ConventionExempleAvantage
Identifiant d’EA + version240214Simple, lisible dans l’historique
Identifiant d’EA + unité de temps2402 × 100 + 60 pour H1Plusieurs instances du même EA sur différentes unités de temps
Paramètre d’entréeinput int InpMagicL’utilisateur choisit et évite les doublons

La solution la plus souple combine les deux : un numéro par défaut propre à l’EA, exposé en paramètre pour que l’utilisateur puisse le changer s’il fait tourner deux instances avec des réglages différents. Évitez 0, réservé de fait aux ordres manuels, et documentez le numéro utilisé dans la notice de l’EA.

Utiliser le numéro dans un EA

#property strict

input int    InpMagic = 240214;   // Numéro magique (unique par instance)
input double InpLots  = 0.10;     // Volume

//+------------------------------------------------------------------+
//| Vrai si l'ordre sélectionné appartient à cet EA sur ce symbole    |
//+------------------------------------------------------------------+
bool EstAMoi()
  {
   return(OrderSymbol() == Symbol() && OrderMagicNumber() == InpMagic);
  }

//+------------------------------------------------------------------+
//| Nombre de positions de l'EA (achats + ventes)                     |
//+------------------------------------------------------------------+
int MesPositions()
  {
   int n = 0;
   for(int i = OrdersTotal() - 1; i >= 0; i--)
      if(OrderSelect(i, SELECT_BY_POS, MODE_TRADES) && EstAMoi() && OrderType() <= OP_SELL)
         n++;
   return(n);
  }

int OnInit()
  {
   if(InpMagic == 0)
     {
      Print("Le numéro magique 0 est réservé aux ordres manuels");
      return(INIT_PARAMETERS_INCORRECT);
     }
   // au redémarrage, l'EA retrouve ses positions grâce au numéro magique
   PrintFormat("EA démarré, %d position(s) existante(s) avec le magic %d",
               MesPositions(), InpMagic);
   return(INIT_SUCCEEDED);
  }

void OnTick()
  {
   if(MesPositions() > 0)
      return;                        // une seule position à la fois pour cet EA

   RefreshRates();
   int ticket = OrderSend(Symbol(), OP_BUY, InpLots, NormalizeDouble(Ask, Digits), 10,
                          0, 0, "OptiBot", InpMagic, 0, clrBlue);
   if(ticket < 0)
      PrintFormat("OrderSend échoué : erreur %d", GetLastError());
  }

La fonction EstAMoi() centralise le filtre : toutes les boucles de l’EA (comptage, trailing, fermeture, historique) l’utilisent, ce qui garantit qu’aucune n’oublie l’une des deux conditions. Le contrôle dans OnInit() refuse un numéro nul et affiche le nombre de positions retrouvées : au redémarrage, vous voyez immédiatement que l’EA a repris la main sur ses ordres. Les boucles elles-mêmes sont expliquées dans OrderSelect et boucles.

Plusieurs stratégies sur un même compte

Le numéro magique permet de faire tourner plusieurs EA, ou plusieurs instances du même EA, sans interférence :

  • Même EA, symboles différents : le filtre sur le symbole suffit à séparer les instances, mais un numéro distinct par instance facilite l’analyse de l’historique.
  • Même EA, même symbole, réglages différents : un numéro distinct par instance est obligatoire, sinon chaque instance verra les positions de l’autre et n’ouvrira plus.
  • EA différents sur le même symbole : chacun doit avoir son propre numéro.
  • Trading manuel en parallèle : les ordres manuels (magic 0) sont ignorés par tous les EA correctement filtrés.

Dans l’historique, le numéro magique permet aussi de calculer la performance de chaque stratégie séparément, comme le montre la page Historique des ordres. C’est une information précieuse pour décider quelle stratégie conserver, réduire ou arrêter. La notion est définie plus largement dans le glossaire : magic number.

Ce que le numéro magique ne fait pas

  • Il ne protège pas contre une erreur de filtre. Si une boucle oublie de tester le numéro, elle agit sur tous les ordres.
  • Il ne sépare pas le risque. Deux EA aux numéros différents partagent la même marge et le même capital : leurs pertes s’additionnent. Le risque global du compte doit être pensé au-delà de chaque EA.
  • Il ne se modifie pas. OrderModify() ne change pas le numéro magique d’un ordre existant. Changer le paramètre d’un EA en cours de route lui fait « oublier » ses positions ouvertes sous l’ancien numéro.

Ce dernier point est la cause d’incidents fréquents : un utilisateur change le numéro magique dans les propriétés de l’EA alors que des positions sont ouvertes. L’EA ne les reconnaît plus, ne les gère plus (plus de trailing, plus de sortie sur signal) et peut en ouvrir de nouvelles. Si vous devez changer le numéro, faites-le sans position ouverte.

Documenter les numéros utilisés

Lorsque plusieurs EA tournent sur un même compte, tenez un registre simple des numéros magiques attribués : nom de l’EA, symbole, unité de temps, réglages principaux et date de mise en service. Ce registre évite les doublons lors de l’ajout d’une nouvelle stratégie et permet de relier chaque ligne de l’historique à la bonne instance quand vous analysez les résultats plusieurs mois plus tard.

Pièges fréquents

  • Laisser la valeur par défaut sur deux instances du même EA sur le même symbole.
  • Utiliser 0 : l’EA confond ses ordres avec les ordres manuels.
  • Filtrer sur le commentaire plutôt que sur le numéro magique.
  • Oublier le filtre dans une seule fonction, typiquement celle qui ferme tout en fin de semaine.
  • Réutiliser un ancien numéro : si un EA arrêté a laissé des positions ouvertes, un nouvel EA qui reprend son numéro magique les considérera comme les siennes et pourra les gérer selon sa propre logique.

Et en MQL5 ?

Le principe est le même en MQL5 : le champ magic de MqlTradeRequest, ou CTrade::SetExpertMagicNumber(), attache le numéro aux ordres, et PositionGetInteger(POSITION_MAGIC) le relit sur les positions. En mode netting, où il n’y a qu’une position par symbole, deux EA sur le même symbole partagent toutefois la même position, ce qui change la façon de concevoir leur cohabitation. Voir Des ordres MQL4 aux positions MQL5.

FAQ

À quoi sert le magic number en MQL4 ?

À identifier les ordres d’un EA. En filtrant sur le symbole et le numéro magique, l’EA ne gère que ses propres ordres et les retrouve après un redémarrage.

Quel numéro magique choisir ?

N’importe quel entier non nul, unique pour chaque instance d’EA sur un même compte et un même symbole. Exposez-le en paramètre pour que l’utilisateur puisse l’ajuster.

Peut-on changer le numéro magique d’un ordre ouvert ?

Non, OrderModify() ne permet pas de le modifier. Changer le paramètre de l’EA alors que des positions sont ouvertes lui fait perdre leur suivi.

Quel est le numéro magique des ordres manuels ?

0. C’est pourquoi un EA ne doit jamais utiliser 0 comme numéro magique.

Le numéro magique sépare les ordres, pas le risque : plusieurs EA sur un même compte partagent la même marge. Définissez un risque global maximal et testez la cohabitation sur compte de démonstration avant usage réel.
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.