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

MQL5 · Bases du langage

Structures en MQL5 : struct, MqlRates et MqlTick

Regrouper des données avec struct, lire des bougies complètes avec MqlRates et CopyRates, obtenir le dernier tick avec MqlTick et SymbolInfoTick : membres, règles de copie et exemple commenté.

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

Une structure (struct) regroupe sous un même nom plusieurs variables de types différents, appelées membres. MQL5 en fournit plusieurs toutes faites, dont deux essentielles pour lire le marché : MqlRates, qui décrit une bougie complète (heure, ouverture, plus haut, plus bas, clôture, volumes, spread), et MqlTick, qui décrit le dernier tick (bid, ask, last, volume, heure en millisecondes). On remplit un tableau de MqlRates avec CopyRates() et un MqlTick avec SymbolInfoTick(). Vous pouvez aussi déclarer vos propres structures pour transporter proprement des données liées : un signal, un niveau de prix, des statistiques de trading.

Cette page fait partie de la rubrique Les bases du langage MQL5.

Déclarer une structure

La syntaxe est la suivante :

struct NiveauPrix
  {
   datetime heure;     // heure de detection
   double   prix;      // niveau
   int      touches;   // nombre de contacts
   bool     actif;     // niveau encore valide ?
  };

Le point-virgule après l’accolade fermante est obligatoire. La documentation précise que le nom d’une structure ne peut pas servir d’identifiant (nom de variable ou de fonction) et qu’une structure ne peut être déclarée qu’une fois dans un projet. On déclare ensuite des variables de ce type comme pour un type simple : NiveauPrix support;, puis on accède aux membres avec le point : support.prix = 1.0850;.

Initialiser et remettre à zéro

Une structure peut être initialisée entre accolades. La documentation indique que les membres non précisés valent alors zéro, et donne l’exemple MqlTradeRequest request = {};, qui remet tous les champs à zéro. Pour réinitialiser une structure existante, ZeroMemory(variable) remet tous ses membres à zéro ; pour un membre de type chaîne, l’effet équivaut à lui affecter NULL.

Structures simples et copie

La documentation appelle structures simples celles qui ne contiennent ni chaînes, ni objets de classe, ni pointeurs, ni tableaux dynamiques. Les structures simples peuvent être copiées par affectation entre variables du même type, ou de types liés par héritage. Une structure qui contient une chaîne ou un tableau dynamique reçoit un constructeur implicite généré par le compilateur pour initialiser correctement ces membres.

Par défaut, les membres sont placés en mémoire sans remplissage, dans l’ordre de déclaration. L’attribut pack(n) modifie cet alignement ; la documentation précise qu’il ne sert qu’aux échanges avec des DLL.

Passer une structure à une fonction

Les structures sont toujours passées par référence. Une fonction qui reçoit const MqlRates &barre peut la lire sans copie et sans risque de la modifier. Une fonction peut aussi renvoyer une structure avec return.

MqlRates : une bougie complète

La structure MqlRates comporte huit membres, documentés comme suit :

MembreTypeContenu
timedatetimeHeure d’ouverture de la période
opendoublePrix d’ouverture
highdoublePlus haut de la période
lowdoublePlus bas de la période
closedoublePrix de clôture
tick_volumelongVolume en ticks
spreadintSpread
real_volumelongVolume réel échangé

CopyRates() remplit un tableau de MqlRates. Elle existe en trois variantes : par position de départ et nombre de barres, par date de départ et nombre de barres, ou entre deux dates. Elle renvoie le nombre d’éléments copiés, ou -1 en cas d’erreur. La documentation précise que, quel que soit le réglage du tableau, l’élément le plus ancien est stocké au début de la mémoire : appelez ArraySetAsSeries() si vous voulez que l’index 0 soit la barre en cours. Ce point est détaillé dans ArraySetAsSeries et indexation des séries.

L’intérêt de CopyRates() est d’obtenir en un appel toutes les informations d’une bougie, là où il faudrait sinon appeler CopyOpen(), CopyHigh(), CopyLow(), CopyClose() et CopyTime() séparément.

MqlTick : le dernier tick

MqlTick décrit une cotation :

MembreTypeContenu
timedatetimeHeure de la dernière mise à jour des prix
biddoublePrix bid courant
askdoublePrix ask courant
lastdoublePrix de la dernière transaction
volumeulongVolume au dernier prix
time_msclongHeure de la dernière mise à jour, en millisecondes
flagsuintDrapeaux du tick
volume_realdoubleVolume au dernier prix, avec une précision accrue

Le membre flags indique ce qui a changé : TICK_FLAG_BID, TICK_FLAG_ASK, TICK_FLAG_LAST, TICK_FLAG_VOLUME, TICK_FLAG_BUY et TICK_FLAG_SELL. Il se teste avec l’opérateur &.

SymbolInfoTick(symbole, tick) remplit la structure et renvoie true en cas de succès. La documentation de SymbolInfoDouble() recommande d’ailleurs d’utiliser SymbolInfoTick() lorsqu’on veut les informations du dernier tick : on obtient bid, ask et heure de façon cohérente, en un seul appel.

Les autres structures prédéfinies

MQL5 utilise des structures dans de nombreux domaines. Vous rencontrerez notamment MqlDateTime pour décomposer une date (voir Dates, heures et fuseaux), ainsi que MqlTradeRequest et MqlTradeResult pour envoyer un ordre et lire la réponse du serveur, présentées dans OrderSend et MqlTradeRequest.

Exemple complet : bougies, tick et structure personnalisée

//+------------------------------------------------------------------+
//| Script : MqlRates, MqlTick et structure personnalisee            |
//+------------------------------------------------------------------+
struct StatsBougies
  {
   int    haussieres;      // nombre de bougies haussieres
   int    baissieres;      // nombre de bougies baissieres
   double amplitudeMoy;    // amplitude moyenne high - low (en prix)
   long   volumeTotal;     // somme des volumes en ticks
  };

//--- Analyse un tableau de bougies (passe par reference, en lecture seule)
StatsBougies Analyser(const MqlRates &barres[], int n)
  {
   StatsBougies st = {};                 // tous les membres a zero
   double somme = 0.0;
   for(int i = 0; i < n; i++)
     {
      if(barres[i].close > barres[i].open)       st.haussieres++;
      else if(barres[i].close < barres[i].open)  st.baissieres++;
      somme          += barres[i].high - barres[i].low;
      st.volumeTotal += barres[i].tick_volume;
     }
   if(n > 0)
      st.amplitudeMoy = somme / n;
   return(st);
  }

void OnStart()
  {
   //--- 1. Les 50 dernieres bougies cloturees (on commence a l'index 1)
   MqlRates barres[];
   ArraySetAsSeries(barres, true);            // barres[0] = derniere bougie cloturee
   int n = CopyRates(_Symbol, _Period, 1, 50, barres);
   if(n <= 0)
     {
      Print("CopyRates a echoue, erreur ", GetLastError());
      return;
     }
   PrintFormat("Derniere bougie cloturee : %s O=%.*f C=%.*f spread=%d",
               TimeToString(barres[0].time), _Digits, barres[0].open,
               _Digits, barres[0].close, barres[0].spread);

   StatsBougies st = Analyser(barres, n);
   PrintFormat("%d haussieres, %d baissieres, amplitude moyenne %.1f points",
               st.haussieres, st.baissieres, st.amplitudeMoy / _Point);

   //--- 2. Le dernier tick
   MqlTick tick;
   if(!SymbolInfoTick(_Symbol, tick))
     {
      Print("SymbolInfoTick a echoue, erreur ", GetLastError());
      return;
     }
   bool bidChange = ((tick.flags & TICK_FLAG_BID) != 0);
   PrintFormat("Bid %.*f Ask %.*f | heure ms %I64d | bid modifie : %s",
               _Digits, tick.bid, _Digits, tick.ask, tick.time_msc,
               bidChange ? "oui" : "non");
  }

La fonction Analyser() reçoit le tableau de bougies en const et renvoie une structure personnalisée : le code appelant récupère quatre résultats en un seul appel, sans variables globales.

Quand créer sa propre structure

Une structure personnalisée devient utile dès que plusieurs valeurs voyagent toujours ensemble. Quelques cas typiques dans un Expert Advisor :

  • un signal : sens, prix d’entrée théorique, stop, objectif et heure de la bougie qui l’a produit. La fonction de signal renvoie une seule structure au lieu de remplir cinq variables globales ;
  • un niveau de prix : support ou résistance détecté, avec son heure, son nombre de contacts et son statut ;
  • des statistiques de session : nombre de trades, profit cumulé, plus forte perte, calculés une fois par jour et journalisés ;
  • un symbole suivi dans un EA multi-symboles : nom, handle d’indicateur, heure de la dernière bougie traitée, rangés dans un tableau de structures.

Le gain est double. Les signatures de fonctions restent courtes et explicites, et l’ajout d’un champ (par exemple un commentaire ou un identifiant de stratégie) ne casse aucun appel existant. Lorsque la structure doit en plus porter des comportements (méthodes, données privées, héritage), la classe devient l’outil adapté : c’est l’objet de Programmation orientée objet : classes. Retenez aussi qu’un tableau de structures se manipule avec les mêmes fonctions qu’un tableau de nombres : ArrayResize(), ArraySize() ou ArrayFree().

Pièges fréquents

  • Oublier le point-virgule après l’accolade fermante de la déclaration : erreur de compilation.
  • Structure locale non initialisée : ses membres sont indéterminés. Utilisez = {} ou ZeroMemory().
  • Lire barres[0] sans vérifier CopyRates() : si la copie échoue, le tableau est vide et l’accès provoque une erreur critique.
  • Prendre la bougie en cours pour une bougie close : avec un départ à 0, l’index 0 en mode série est la bougie en formation, dont close change à chaque tick.
  • Copier deux structures de types différents : refusé par le compilateur, même avec une conversion explicite, sauf lien d’héritage.
  • Confondre volume et volume_real : le second offre une précision accrue ; les deux concernent le dernier prix de transaction, renseigné surtout sur les marchés boursiers.

FAQ

Quelle différence entre MqlRates et MqlTick ?

MqlRates décrit une bougie entière (ouverture, plus haut, plus bas, clôture, volumes, spread) ; MqlTick décrit une cotation instantanée (bid, ask, last, volume, heure en millisecondes). On utilise le premier pour l’analyse des bougies, le second pour les prix d’exécution.

Comment remettre une structure à zéro ?

À la déclaration, initialisez-la avec = {} ; ensuite, appelez ZeroMemory(variable). Tous les membres numériques passent à zéro et les chaînes sont vidées.

Une structure est-elle copiée quand je la passe à une fonction ?

Non. Les structures sont toujours passées par référence. Ajoutez const devant le paramètre si la fonction ne doit pas la modifier.

Peut-on mettre une chaîne ou un tableau dynamique dans une structure ?

Oui, mais la structure n’est alors plus une structure simple : elle ne peut pas être transmise à une DLL et le compilateur lui ajoute un constructeur implicite pour initialiser ces membres.

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.