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

MQL5 · Expert Advisors

Variables globales du terminal en MQL5 : GlobalVariableSet, persistance et verrous

Stocker un état numérique qui survit aux redémarrages et coordonner plusieurs EA avec les variables globales du terminal MetaTrader 5 : fonctions, nommage, durée de vie et verrou atomique.

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

Les variables globales du terminal sont des paires nom → nombre réel stockées par MetaTrader 5 lui-même, en dehors de tout programme. Un Expert Advisor les écrit avec GlobalVariableSet(nom, valeur) et les relit avec GlobalVariableGet(nom). Elles sont accessibles à tous les programmes MQL5 du même terminal et survivent au redémarrage de l’EA comme à celui du terminal. Elles sont idéales pour mémoriser un petit état numérique (un capital de référence, une date, un compteur, un drapeau) ou pour coordonner plusieurs EA. Elles sont supprimées automatiquement après quatre semaines sans accès.

Cette page de la rubrique Construire un Expert Advisor en MQL5 présente les fonctions, les règles de nommage et deux usages concrets : la persistance d’un état et le verrou partagé entre EA. À ne pas confondre avec les variables déclarées au niveau global dans un programme, décrites dans Variables, constantes et portée, qui disparaissent quand l’EA est rechargé.

Les fonctions disponibles

FonctionRôle
GlobalVariableSet(name, value)crée la variable si besoin et lui affecte une valeur ; renvoie l’heure de modification, ou 0 en cas d’échec
GlobalVariableGet(name)renvoie la valeur, ou 0 en cas d’erreur ; une seconde forme GlobalVariableGet(name, var) renvoie true ou false et écrit la valeur dans var
GlobalVariableCheck(name)indique si la variable existe
GlobalVariableDel(name)supprime la variable
GlobalVariableTemp(name)crée une variable temporaire, qui n’existe que pendant la session du terminal
GlobalVariableSetOnCondition(name, value, check)modifie la valeur seulement si elle est égale à check, de façon atomique
GlobalVariableTime(name)heure du dernier accès
GlobalVariablesDeleteAll(prefix)supprime les variables dont le nom commence par un préfixe
GlobalVariablesTotal() et GlobalVariableName(index)énumérer les variables existantes
GlobalVariablesFlush()force l’écriture sur disque des variables non temporaires

Lever l’ambiguïté du zéro

La forme simple de GlobalVariableGet renvoie 0 en cas d’erreur, ce qui est indiscernable d’une valeur réellement nulle. Utilisez la forme à deux paramètres, ou testez d’abord l’existence avec GlobalVariableCheck.

Les règles à respecter

  • Uniquement des nombres. La valeur est de type double. Une date se stocke en convertissant le datetime en double ; un booléen en 0 ou 1. Un texte, une structure ou un tableau ne peuvent pas être stockés : pour cela, utilisez un fichier (voir Sauvegarder l’état dans des fichiers).
  • Des noms de 63 caractères au plus.
  • Un espace partagé. Tous les programmes du terminal voient toutes les variables. Un nom générique comme Compteur sera écrasé par le premier EA qui utilise le même nom. Construisez toujours le nom avec un préfixe unique : nom de l’EA, numéro de compte, symbole, magic number.
  • Une durée de vie limitée. Une variable non lue ni écrite pendant quatre semaines est supprimée. Une lecture suffit à prolonger sa vie. Pour un EA arrêté plus d’un mois, prévoyez une valeur par défaut.
  • Une sauvegarde différée. Les variables sont écrites sur disque par le terminal ; appelez GlobalVariablesFlush() après une modification importante si vous voulez réduire le risque de perte en cas d’arrêt brutal de la machine.

Vous pouvez consulter, modifier ou supprimer les variables à la main dans la fenêtre « Variables globales » du terminal (touche F3). C’est pratique pour vérifier le comportement d’un EA ou pour réinitialiser un état.

Une convention de nommage qui évite les collisions

Adoptez une fois pour toutes un format de nom et appliquez-le à tous vos EA, par exemple NomEA_Compte_Magic_Symbole_Champ. Ce format présente plusieurs avantages : la fenêtre F3 trie les variables par nom, ce qui regroupe naturellement celles d’un même EA ; la suppression ciblée avec GlobalVariablesDeleteAll et un préfixe précis ne touche que l’EA concerné ; le numéro de compte évite qu’un état enregistré sur un compte de démonstration soit relu par erreur sur le compte réel, si les deux sont utilisés dans le même terminal. Vérifiez dans OnInit que le nom le plus long reste sous la limite de 63 caractères : un symbole au nom long avec suffixe de courtier peut suffire à la dépasser.

Exemple 1 : conserver un état entre deux redémarrages

L’EA ci-dessous compte ses entrées de la journée et refuse d’en ouvrir plus qu’un maximum. Le compteur et la date de la journée sont conservés dans deux variables globales du terminal : un redémarrage ou un changement d’unité de temps ne remet pas le compteur à zéro.

#property version "1.00"

input int    InpMaxTradesPerDay = 3;
sinput ulong InpMagic           = 260109;

string g_prefix;   // préfixe unique : compte + magic + symbole

string Key(const string field) { return(g_prefix + field); }

int OnInit()
  {
   g_prefix = StringFormat("EA%I64u_%I64d_%s_", InpMagic,
                           AccountInfoInteger(ACCOUNT_LOGIN), _Symbol);
   if(StringLen(Key("count")) > 63) return(INIT_FAILED);   // limite de longueur du nom
   return(INIT_SUCCEEDED);
  }

//--- renvoie le nombre d'entrées déjà faites aujourd'hui
int TradesToday()
  {
   datetime today = iTime(_Symbol, PERIOD_D1, 0);
   double   storedDay = 0.0, count = 0.0;
   if(!GlobalVariableGet(Key("day"), storedDay) || (datetime)storedDay != today)
     {
      GlobalVariableSet(Key("day"), (double)today);     // nouvelle journée
      GlobalVariableSet(Key("count"), 0.0);
      return(0);
     }
   if(!GlobalVariableGet(Key("count"), count)) return(0);
   return((int)count);
  }

//--- à appeler après chaque entrée réussie
void RegisterTrade()
  {
   GlobalVariableSet(Key("count"), TradesToday() + 1);
   GlobalVariablesFlush();                              // écriture immédiate sur disque
  }

void OnTick()
  {
   if(TradesToday() >= InpMaxTradesPerDay) return;      // quota atteint
   //--- ici : signal, envoi de l'ordre, puis RegisterTrade() si l'ordre est accepté
  }

Exemple 2 : un verrou partagé entre plusieurs EA

Plusieurs EA qui tournent dans le même terminal peuvent avoir besoin de ne pas agir en même temps : par exemple, ne pas recalculer simultanément une exposition globale, ou n’autoriser qu’un seul EA à envoyer un ordre à la fois sur un compte. GlobalVariableSetOnCondition fournit un accès atomique : la modification n’a lieu que si la valeur actuelle est égale à la valeur attendue, et aucun autre programme ne peut s’intercaler entre la comparaison et l’écriture. C’est le mécanisme d’un verrou (mutex).

#define LOCK_NAME "OPTIBOT_TRADE_LOCK"

//--- tente de prendre le verrou ; myId doit être non nul et propre à l'EA (ex. magic number)
bool AcquireLock(const double myId)
  {
   if(!GlobalVariableCheck(LOCK_NAME))
     {
      GlobalVariableTemp(LOCK_NAME);                    // variable de session
      GlobalVariableSet(LOCK_NAME, 0.0);                // 0 = verrou libre
     }
   //--- passe de 0 (libre) à myId (pris) seulement si le verrou est libre
   return(GlobalVariableSetOnCondition(LOCK_NAME, myId, 0.0));
  }

//--- libère le verrou seulement si c'est bien nous qui le détenons
void ReleaseLock(const double myId)
  {
   GlobalVariableSetOnCondition(LOCK_NAME, 0.0, myId);
  }

//--- utilisation :
//--- if(AcquireLock(InpMagic)) { /* section critique : envoi d'ordre */ ReleaseLock(InpMagic); }

Le verrou ne doit protéger que des opérations courtes. Ne le gardez jamais pendant une attente : un EA qui ne parvient pas à l’obtenir doit simplement réessayer au tick ou à l’échéance de minuterie suivante, plutôt que de boucler en attendant sa libération, ce qui bloquerait son propre traitement des événements.

La variable de verrou est créée comme temporaire : si le terminal s’arrête alors qu’un EA détient le verrou, la variable disparaît avec la session et le verrou ne reste pas bloqué au redémarrage. Libérez toujours le verrou dans tous les chemins de sortie de la section critique, y compris en cas d’erreur, sinon les autres EA attendront indéfiniment.

Cas d’usage et limites

  • Bon usage : capital de référence d’une limite de perte journalière, compteur de trades, date de la dernière action, mode de fonctionnement (actif, pause) piloté à la main depuis la fenêtre F3.
  • Coordination : un EA « superviseur » écrit un drapeau d’arrêt d’urgence, que tous les autres EA lisent avant chaque entrée.
  • Mauvais usage : historique de signaux, liste de tickets, paramètres textuels. Un fichier ou une base de données conviennent mieux. Voir aussi Bases de données SQLite pour un stockage structuré.
  • Limite de portée : les variables sont propres à une installation du terminal. Deux terminaux installés sur la même machine ne partagent pas leurs variables globales ; pour cela, il faut un fichier placé dans le dossier commun.

Questions fréquentes

Les variables globales du terminal survivent-elles à un redémarrage de l’ordinateur ?

Oui, les variables non temporaires sont enregistrées sur disque par le terminal et rechargées au démarrage suivant. Les variables créées avec GlobalVariableTemp disparaissent à la fermeture du terminal.

Pourquoi ma variable globale a-t-elle disparu ?

Soit elle n’a pas été lue ni écrite depuis quatre semaines, soit elle était temporaire, soit un autre programme l’a supprimée, par exemple avec GlobalVariablesDeleteAll et un préfixe trop large.

Peut-on stocker une chaîne de caractères dans une variable globale du terminal ?

Non, seules des valeurs numériques de type double sont prises en charge. Pour du texte, utilisez un fichier dans le bac à sable du terminal.

Les variables globales sont-elles partagées avec le Strategy Tester ?

Ne comptez pas sur ce partage : un test doit être autonome et reproductible. Initialisez vos variables dans OnInit lorsque l’EA tourne dans le testeur, ce que vous pouvez détecter avec MQLInfoInteger(MQL_TESTER).

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.