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

MQL5 · Avancé

La bibliothèque standard MQL5 : classes de trading, collections et outils prêts à l’emploi

CTrade, CPositionInfo, CSymbolInfo, CArrayObj, CHashMap, panneaux et modules de stratégie : la carte de la bibliothèque standard livrée avec MetaTrader 5, pour réutiliser du code éprouvé au lieu de le réécrire.

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

La bibliothèque standard MQL5 est un ensemble de classes livrées avec MetaTrader 5, rangées dans le dossier MQL5\Include du terminal. Elle couvre l’exécution des ordres et la lecture des positions (Include\Trade\), les collections de données (Include\Arrays\ et Include\Generic\), les indicateurs, les objets graphiques, les graphiques scientifiques, les panneaux et dialogues, les fichiers, les chaînes et les mathématiques. Vous l’utilisez en incluant le fichier voulu avec #include <Trade\Trade.mqh> par exemple, puis en déclarant un objet de la classe. Bien connue, elle vous fait gagner des centaines de lignes et des heures de débogage.

Cette page, qui appartient à la rubrique MQL5 avancé, vous donne une carte de la bibliothèque et une méthode pour l’explorer. Elle suppose que vous savez lire une classe et une hiérarchie d’héritage : si besoin, commencez par Héritage et polymorphisme.

La carte des dossiers

La documentation officielle organise la bibliothèque en seize sections. Le tableau suivant reprend celles qui servent le plus souvent dans un projet de trading, avec leur emplacement.

SectionDossierUsage typique
Classe de base CObjectInclude\racine commune de la plupart des classes
Collections de donnéesInclude\Arrays\tableaux dynamiques d’objets, listes, arbres
Collections génériquesInclude\Generic\listes, tables de hachage, files, piles typées
Classes de tradingInclude\Trade\ordres, positions, symbole, compte
IndicateursInclude\Indicators\indicateurs techniques encapsulés
Modules de stratégieInclude\Expert\briques de l’assistant MQL5
Panneaux et dialoguesInclude\Controls\boutons, champs, fenêtres
Objets graphiquesInclude\Objects\lignes, flèches, étiquettes
Graphiques personnalisésInclude\Canvas\dessin pixel par pixel
Fichiers et chaînesInclude\Files\, Include\Strings\accès fichier et texte orientés objet
MathématiquesInclude\Math\statistiques, lois de probabilité

La façon la plus efficace d’apprendre consiste à ouvrir ces fichiers .mqh dans MetaEditor : le code source est lisible, commenté, et il montre comment les développeurs de la plateforme utilisent eux-mêmes MQL5.

CObject, la racine commune

La plupart des classes de la bibliothèque héritent de CObject. Cette classe fournit des liens vers l’élément précédent et suivant (Prev, Next) et quatre méthodes virtuelles : Compare, Save, Load et Type. C’est ce qui permet aux collections de trier ou d’enregistrer n’importe quel objet : si votre propre classe hérite de CObject et redéfinit Compare, un CArrayObj saura la trier.

Les classes de trading

Le dossier Include\Trade\ contient huit classes :

  • CTrade : exécute les opérations de trading (ouvrir, modifier, fermer, placer un ordre en attente) ;
  • CPositionInfo : lit les propriétés d’une position ouverte ;
  • COrderInfo : lit les propriétés d’un ordre en attente ;
  • CHistoryOrderInfo et CDealInfo : lisent les ordres et transactions de l’historique ;
  • CSymbolInfo : lit les propriétés d’un instrument ;
  • CAccountInfo : lit les propriétés du compte ;
  • CTerminalInfo : lit les propriétés du terminal.

CTrade mérite une page à elle seule : elle est traitée dans La classe CTrade. Les classes d’information sont des enveloppes pratiques autour des fonctions natives. CPositionInfo propose par exemple SelectByIndex, SelectByTicket et SelectByMagic pour la sélection, puis des accesseurs comme Symbol, Volume, PriceOpen, StopLoss, Profit ou Magic. Ses méthodes StoreState et CheckState mémorisent l’état d’une position et détectent une modification. CSymbolInfo regroupe les cotations (Bid, Ask), le spread, les niveaux StopsLevel et FreezeLevel, les contraintes de volume (LotsMin, LotsMax, LotsStep), les valeurs de tick et une méthode de service NormalizePrice. Point clé : il faut appeler RefreshRates pour mettre à jour les cotations de l’objet avant de les lire.

Les collections : Arrays et Generic

Deux familles coexistent. La plus ancienne, dans Include\Arrays\, fournit des tableaux dynamiques typés (CArrayInt, CArrayDouble, CArrayString…), un tableau de pointeurs CArrayObj, une liste chaînée CList et un arbre binaire CTree. CArrayObj gère par défaut la mémoire de ses éléments : quand le mode de libération (FreeMode) est actif, ce qui est le cas par défaut, supprimer un élément ou vider le tableau détruit aussi les objets. C’est confortable, mais cela signifie qu’un objet ajouté au tableau ne doit pas être supprimé une seconde fois par vous.

La famille générique, dans Include\Generic\, repose sur des modèles (templates) et fonctionne avec n’importe quel type : CArrayList<T>, CHashMap<TKey,TValue>, CHashSet<T>, CQueue<T>, CStack<T>, CLinkedList<T>, CSortedMap<TKey,TValue> et CSortedSet<T>. Pour un EA, CHashMap est la plus utile : associer un symbole à un état, un magic number à une stratégie, un ticket à une heure d’ouverture. Sa méthode TryGetValue(key, value) renvoie false si la clé est absente, ce qui évite les recherches linéaires dans un tableau.

Exemple complet : un état des positions par symbole

Le script suivant parcourt les positions ouvertes avec CPositionInfo, agrège volume et profit par symbole dans deux CHashMap, puis affiche le spread courant de chaque symbole via CSymbolInfo et le solde via CAccountInfo.

//+------------------------------------------------------------------+
//| PositionsReport.mq5 : script utilisant la bibliothèque standard  |
//+------------------------------------------------------------------+
#include <Trade\PositionInfo.mqh>
#include <Trade\SymbolInfo.mqh>
#include <Trade\AccountInfo.mqh>
#include <Generic\HashMap.mqh>

void OnStart()
  {
   CPositionInfo pos;
   CSymbolInfo   sym;
   CAccountInfo  acc;
   CHashMap<string,double> volumes;   // symbole -> volume total
   CHashMap<string,double> profits;   // symbole -> profit total

   //--- 1. agrégation des positions ouvertes
   for(int i=PositionsTotal()-1;i>=0;i--)
     {
      if(!pos.SelectByIndex(i))
         continue;
      string s=pos.Symbol();
      double v=0.0,p=0.0;
      if(volumes.TryGetValue(s,v))
        {
         profits.TryGetValue(s,p);
         volumes.TrySetValue(s,v+pos.Volume());
         profits.TrySetValue(s,p+pos.Profit());
        }
      else
        {
         volumes.Add(s,pos.Volume());
         profits.Add(s,pos.Profit());
        }
     }

   //--- 2. affichage
   PrintFormat("Compte : solde %.2f %s, %d symbole(s) en position",
               acc.Balance(),acc.Currency(),volumes.Count());
   string keys[];
   double vals[];
   volumes.CopyTo(keys,vals);
   for(int k=0;k<ArraySize(keys);k++)
     {
      double pr=0.0;
      profits.TryGetValue(keys[k],pr);
      if(!sym.Name(keys[k]) || !sym.RefreshRates())
         continue;                          // symbole indisponible
      PrintFormat("%-10s volume %.2f  profit %.2f  spread %d points",
                  keys[k],vals[k],pr,sym.Spread());
     }
  }

Ce script ne modifie rien : il lit seulement. Il illustre trois habitudes à prendre avec la bibliothèque. On vérifie le retour des méthodes de sélection (SelectByIndex) avant de lire les propriétés. On rafraîchit les cotations de CSymbolInfo avant de les utiliser. Et on préfère une table de hachage à un tableau parallèle quand on doit retrouver une valeur par clé. Pour les règles de parcours des positions, voyez aussi Parcourir et filtrer les positions.

Indicateurs, panneaux et modules de stratégie

Le dossier Include\Indicators\ encapsule les indicateurs techniques dans des classes qui gèrent la création du handle et la copie des buffers. Elles sont surtout utilisées par les modules de stratégie de Include\Expert\, sur lesquels s’appuie l’assistant de MetaEditor : un expert y est assemblé à partir d’un module de signal, d’un module de suivi (trailing) et d’un module de gestion du capital. Ces modules illustrent parfaitement l’architecture par classes abstraites. Pour un usage quotidien, beaucoup de développeurs préfèrent toutefois appeler directement iMA et CopyBuffer, plus transparents.

Le dossier Include\Controls\ fournit CAppDialog, CButton, CEdit, CLabel et d’autres contrôles pour construire des panneaux interactifs ; leur mise en œuvre est expliquée dans Panneaux et boutons (CAppDialog).

Bibliothèque standard ou code maison ?

La bibliothèque a des avantages évidents : code maintenu par l’éditeur, testé par une large communauté, compatible avec les comptes netting et hedging. Elle a aussi un coût : ses classes sont généralistes et font parfois plus de vérifications ou d’appels que nécessaire. Notre recommandation pratique :

  • utilisez CTrade et les classes d’information pour tout ce qui touche à l’exécution, sauf besoin très spécifique ;
  • utilisez les collections génériques plutôt que d’écrire vos propres listes ou tables de hachage ;
  • n’adoptez les modules de stratégie que si vous acceptez leur architecture ; sinon, inspirez-vous-en dans vos propres classes ;
  • en cas de doute sur un comportement, lisez le fichier source : il fait foi.

Pièges fréquents

  • Cotations figées : lire sym.Bid() sans RefreshRates() renvoie la dernière valeur mémorisée par l’objet, pas forcément la cotation actuelle.
  • Double libération avec CArrayObj : en mode de libération actif, ne supprimez pas vous-même un objet resté dans le tableau.
  • Modifier les fichiers de la bibliothèque : une mise à jour du terminal peut écraser vos changements. Dérivez une classe dans votre propre dossier plutôt que d’éditer l’original.
  • Mélanger les deux familles de collections sans raison : choisissez les génériques pour du code neuf.

Questions fréquentes

Où se trouvent les fichiers de la bibliothèque standard ?

Dans le dossier MQL5\Include du répertoire de données du terminal, accessible depuis MetaEditor ou via Fichier puis Ouvrir le dossier des données dans MetaTrader 5. Chaque section a son sous-dossier, par exemple Trade, Arrays, Generic ou Controls.

La bibliothèque standard fonctionne-t-elle en netting et en hedging ?

Les classes de trading sont conçues pour les deux modes. Il reste à votre code de tenir compte du modèle de compte, par exemple pour fermer une position précise en hedging. La page sur les comptes netting et hedging de la rubrique trading détaille ces différences.

Quelle collection choisir pour associer une valeur à un symbole ?

CHashMap<string,T> du dossier Generic est le choix naturel : ajout avec Add, lecture avec TryGetValue, modification avec TrySetValue. Pour un ensemble trié par clé, utilisez CSortedMap.

Puis-je publier sur le Market un EA qui utilise la bibliothèque standard ?

Oui. Les fichiers inclus sont compilés dans votre fichier EX5 ; il n’y a aucune dépendance externe à livrer à l’acheteur.

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.