MQL4 · Migration MQL5
Différences entre MQL4 et MQL5 : la carte complète avant de migrer
Modèle de trading, indicateurs, séries de prix, propriétés du symbole, testeur, erreurs : ce qui change vraiment entre MQL4 et MQL5, et ce qui reste identique, pour décider et planifier une migration.
MQL4 et MQL5 se ressemblent au premier regard : même syntaxe inspirée du C++, mêmes fonctions événementielles, mêmes types de base. Pourtant, un EA MQL4 ne compile pas tel quel en MQL5, et la raison n’est pas syntaxique. Les deux langages reposent sur des modèles différents pour accéder au marché : la façon de représenter les ordres et les positions, de lire un indicateur, d’obtenir le prix d’une bougie ou une propriété du symbole. Cette page dresse la carte de ces différences, domaine par domaine, pour que vous sachiez exactement ce qu’une migration implique avant de l’entreprendre.
Elle ne détaille pas le code de chaque remplacement : chaque domaine dispose de sa propre page dans la rubrique Migrer de MQL4 vers MQL5. Ici, l’objectif est la vue d’ensemble.
Ce qui est commun
Depuis la refonte de MQL4 en 2014 (build 600), les deux langages ont beaucoup convergé. Sont communs, à quelques détails près :
- les fonctions événementielles
OnInit,OnDeinit,OnTick,OnTimer,OnChartEvent, et pour les indicateursOnCalculate; - les types de données, y compris
datetime,color, les énumérations et les structures ; - la programmation orientée objet : classes, héritage, fonctions virtuelles ;
- les directives du préprocesseur (
#property,#include,#define) et les paramètresinput; - la plupart des fonctions mathématiques, de chaînes, de temps, de fichiers et d’objets graphiques ;
- une partie des fonctions d’information sur le symbole, comme
SymbolInfoDoubleetSymbolInfoTick, disponibles dans les deux langages.
Un code MQL4 moderne, compilé sous #property strict, est donc déjà proche de MQL5 pour toute sa partie « calcul ». Les anciennes fonctions init(), start() et deinit() de MQL4, en revanche, doivent être remplacées par leurs équivalents événementiels.
Différence n° 1 : le modèle de trading
C’est le changement le plus profond. En MQL4, tout est ordre : une position ouverte est un ordre au marché, identifié par un ticket, sélectionné avec OrderSelect et fermé avec OrderClose. MQL5 distingue trois entités :
- l’ordre est une instruction envoyée au serveur (acheter, vendre, placer un ordre limite) ;
- la transaction (*deal*) est l’exécution effective d’un ordre, qui modifie le compte ;
- la position est l’exposition résultante sur un symbole.
S’y ajoute la notion de mode de compte. Sur un compte en *netting*, il ne peut exister qu’une position par symbole : un nouvel achat sur un symbole déjà acheté augmente la position existante, une vente la réduit. Sur un compte en *hedging*, plusieurs positions peuvent coexister sur un même symbole, comme en MT4. Un EA qui ouvre plusieurs positions indépendantes sur un symbole doit donc vérifier le mode du compte. Le détail du portage est donné dans Des ordres MQL4 aux positions MQL5.
Côté code, OrderSend existe dans les deux langages mais n’a pas la même signature : en MQL4, il prend une dizaine de paramètres et renvoie un ticket ; en MQL5, il reçoit une structure MqlTradeRequest, remplit une structure MqlTradeResult et renvoie un booléen. La classe CTrade de la bibliothèque standard simplifie l’envoi avec des méthodes comme Buy, Sell, PositionModify ou PositionClose.
Différence n° 2 : les indicateurs
En MQL4, iMA(Symbol(), 0, 20, 0, MODE_SMA, PRICE_CLOSE, 1) renvoie directement la valeur de la moyenne mobile sur la bougie d’indice 1. En MQL5, la fonction iMA ne prend pas de décalage et renvoie un handle, un identifiant de l’instance d’indicateur créée par le terminal. Les valeurs se lisent ensuite avec CopyBuffer, qui copie un ou plusieurs éléments d’un buffer dans un tableau.
Ce modèle impose de créer les handles une seule fois, généralement dans OnInit, de vérifier qu’ils sont valides, puis de copier les valeurs à chaque besoin. Il est plus verbeux, mais plus efficace : l’indicateur est calculé une fois par le terminal au lieu d’être recalculé à chaque appel. Voir Des fonctions iXXX aux handles.
Différence n° 3 : les séries de prix
MQL4 fournit des tableaux prédéfinis pour le symbole et la période du graphique : Open[], High[], Low[], Close[], Time[], Volume[], ainsi que la variable Bars. Ils n’existent pas en MQL5. On les remplace par des fonctions d’accès unitaire (iClose, iTime, iHigh… qui existent aussi en MQL5 dans les versions récentes) ou par des fonctions de copie (CopyRates, CopyClose, CopyTime) associées à ArraySetAsSeries pour retrouver l’indexation inversée habituelle. La page de la rubrique consacrée au remplacement de Close[] et Time[] détaille ces équivalences.
Différence n° 4 : prix et propriétés du symbole
Les variables prédéfinies Bid et Ask n’existent pas en MQL5, pas plus que MarketInfo. On lit les prix avec SymbolInfoTick ou SymbolInfoDouble(_Symbol, SYMBOL_BID), et les propriétés du symbole avec SymbolInfoDouble, SymbolInfoInteger et SymbolInfoString. _Point et _Digits restent disponibles dans les deux langages. La correspondance complète des identifiants MODE_... est donnée dans la page MarketInfo vers SymbolInfo de cette rubrique.
Différence n° 5 : les périodes
Les constantes de période portent les mêmes noms (PERIOD_M1, PERIOD_H1, PERIOD_D1…), mais en MQL5 elles appartiennent à l’énumération ENUM_TIMEFRAMES et leurs valeurs numériques ne correspondent plus au nombre de minutes. Un code MQL4 qui écrit 60 pour désigner l’unité horaire, ou qui calcule une durée en multipliant la période par 60, doit être corrigé. MQL5 ajoute aussi des périodes absentes de MT4, comme M2, M12, H2 ou H12.
Différence n° 6 : les erreurs
La gestion des erreurs change de nature pour le trading. En MQL4, l’échec d’un ordre se lit avec GetLastError(), qui renvoie par exemple 130 ou 138. En MQL5, le refus du serveur se lit dans le champ retcode de la structure MqlTradeResult, ou avec la méthode ResultRetcode() de CTrade, avec des codes comme 10004 (recotation) ou 10016 (stops invalides). Les erreurs d’exécution, elles, restent lues avec GetLastError(), mais leur numérotation est différente. Les correspondances cause par cause figurent dans la rubrique Codes d’erreur MQL4.
Différence n° 7 : le testeur de stratégie
Le testeur de MT5 est multi-cœur, multi-devises, et peut modéliser sur ticks réels lorsque le courtier fournit l’historique de ticks. Celui de MT4 teste un symbole à la fois avec des ticks générés à partir des bougies. Les résultats ne sont donc pas directement comparables ; la page Testeur MT4 contre testeur MT5 de cette rubrique explique comment comparer ce qui est comparable.
Tableau récapitulatif
| Domaine | MQL4 | MQL5 | Effort de migration |
|---|---|---|---|
| Événements | OnTick, ou anciennement start() | OnTick | Faible |
| Ordres et positions | Ordres et tickets | Ordres, transactions, positions | Élevé |
| Indicateurs | Valeur directe avec décalage | Handle et CopyBuffer | Moyen |
| Séries de prix | Close[], Time[], Bars | iClose, CopyRates, Bars() | Moyen |
| Prix courants | Bid, Ask | SymbolInfoTick | Faible |
| Propriétés | MarketInfo | SymbolInfo* | Faible |
| Erreurs de trading | GetLastError() | Code de retour du résultat | Moyen |
Que retenir pour planifier ?
La logique de votre stratégie, c’est-à-dire les conditions d’entrée, les filtres, la gestion du risque et les calculs, se conserve en grande partie. Ce qui doit être réécrit, c’est la couche d’accès au marché. Plus cette couche est isolée dans votre code, plus la migration est rapide. La méthode concrète est décrite dans Convertir un EA MQL4 en MQL5.
Questions fréquentes
MQL5 est-il plus difficile que MQL4 ?
Il est plus verbeux pour certaines opérations, comme la lecture d’un indicateur ou l’envoi d’un ordre, mais pas fondamentalement plus difficile. La classe CTrade et les fonctions d’accès unitaire aux séries réduisent beaucoup cet écart.
Un code MQL4 compile-t-il dans MetaEditor 5 ?
Rarement sans modification. Les fonctions de calcul passent, mais les fonctions de trading, les indicateurs, les tableaux de séries et MarketInfo provoquent des erreurs qu’il faut corriger une à une.
Qu’est-ce que le mode netting ?
Un mode de compte MT5 dans lequel une seule position peut exister par symbole. Les ordres successifs sur un symbole augmentent, réduisent ou retournent cette position, au lieu d’ouvrir des positions indépendantes.
Les constantes PERIOD_H1 ont-elles la même valeur en MQL4 et en MQL5 ?
Le nom est le même, mais pas la valeur numérique. En MQL5, utilisez toujours les constantes de l’énumération ENUM_TIMEFRAMES, jamais des nombres de minutes, et la fonction PeriodSeconds() pour obtenir une durée.
