MQL4 · Migration MQL5
Checklist de migration MQL4 vers MQL5 : tout vérifier avant la mise en production
Préparation, code, trading, indicateurs, erreurs, tests, déploiement : la liste de contrôle complète pour valider un EA porté de MQL4 vers MQL5 avant de le confier à un compte réel.
Une migration de MQL4 vers MQL5 se termine rarement par une erreur spectaculaire : elle échoue plutôt sur un détail oublié, un OrdersTotal() qui ne compte plus les positions, un indice décalé d’une bougie, un code de retour non testé. Cette checklist rassemble, dans l’ordre d’une migration, tous les points de contrôle présentés dans la rubrique Migrer de MQL4 vers MQL5. Utilisez-la comme une liste de contrôle : chaque point non vérifié est un risque de comportement différent de l’original.
Elle ne remplace pas les pages détaillées, vers lesquelles elle renvoie pour chaque domaine. Elle sert à s’assurer que rien n’a été oublié avant de confier l’EA porté à un compte réel.
1. Préparation dans MQL4
- La version MQL4 compile sans erreur ni avertissement sous
#property strict. - Les anciennes fonctions
init(),start()etdeinit()ont été remplacées parOnInit(),OnTick()etOnDeinit(). - Un backtest de référence a été réalisé et sa liste de transactions exportée.
- Les appels au marché sont regroupés dans une couche d’abstraction : prix, propriétés, séries, indicateurs, ouverture, fermeture, comptage.
MarketInfo,Bid,Askont été remplacés dans MQL4 parSymbolInfoDouble,SymbolInfoIntegerouSymbolInfoTick, sauf la marge requise.- Les tableaux
Close[],Time[], etc. ont été remplacés pariClose,iTimeet leurs voisines. - Le backtest MQL4 après ces modifications est identique au backtest de référence.
- Le code source de tous les indicateurs personnalisés et bibliothèques utilisés est disponible.
La méthode de cette phase est détaillée dans Convertir un EA MQL4 en MQL5.
2. Modèle de trading
- Le mode du compte cible (netting ou hedging) est identifié, et la logique de l’EA est compatible avec ce mode.
- Tous les tests
OrdersTotal()destinés à compter des positions ont été remplacés par un comptage viaPositionsTotal(). - Les positions et les ordres en attente sont parcourus dans des boucles distinctes.
- Le magic number est défini avec
SetExpertMagicNumber(si vous utilisezCTrade) ou dans chaque requête. - Les tickets sont déclarés en
ulong. - Les fermetures partielles utilisent
PositionClosePartialou une transaction opposée, en tenant compte du netting. - Les calculs sur l’historique commencent par
HistorySelectet parcourent les transactions (deals). - Le mode de remplissage des ordres accepté par le symbole est pris en compte.
Voir Des ordres MQL4 aux positions MQL5.
3. Indicateurs
- Chaque indicateur est créé une seule fois dans
OnInit()et son handle comparé àINVALID_HANDLE. - Les handles sont libérés avec
IndicatorRelease()dansOnDeinit(). - Les paramètres de chaque fonction sont vérifiés dans la signature MQL5, notamment l’ordre des paramètres de
iBands. - Le paramètre
modede MQL4 est remplacé par le bon numéro de buffer. - Les tableaux de destination sont indexés avec
ArraySetAsSerieslorsque le code suppose l’indice 0 sur la bougie la plus récente. - Le nombre d’éléments renvoyé par
CopyBufferest testé. - Les valeurs lues sont comparées à celles de la version MQL4 sur les mêmes bougies.
La page de la rubrique consacrée au passage des fonctions iXXX aux handles détaille chacun de ces points.
4. Séries et propriétés
- Aucune référence à
Open[],High[],Low[],Close[],Time[],Volume[]ouBarsne subsiste. - Les retours de
iClose(0 en cas d’erreur) et des fonctions de copie sont testés. - Les périodes sont désignées par des constantes
PERIOD_..., jamais par des nombres de minutes ; les durées sont calculées avecPeriodSeconds(). - Chaque propriété du symbole est lue avec la fonction du bon type (
SymbolInfoDoubleouSymbolInfoInteger). - La marge requise est calculée avec
OrderCalcMargin. - Les appels à
RefreshRates()ont été supprimés. - Les fonctions
Account...()sont remplacées parAccountInfoDoubleetAccountInfoInteger.
5. Gestion des erreurs
- Le résultat de chaque envoi est vérifié par le code de retour (
ResultRetcode()ouresult.retcode), et non seulement par le booléen renvoyé. - Les tests sur les anciens codes MQL4 (129, 130, 138, 146…) sont remplacés par les codes de retour MQL5 correspondants (10015, 10016, 10004…).
- La politique de reprise (codes passagers, nombre d’essais) est reproduite.
- Le journal enregistre code de retour, prix, volume et niveaux pour chaque échec.
Les causes des erreurs d’origine, utiles pour retrouver leur équivalent, sont décrites dans la rubrique Codes d’erreur MQL4.
6. Tests
- La version MQL5 compile sans erreur ni avertissement.
- Un backtest MQL5 aux conditions alignées (mêmes dates, dépôt, levier, spread fixe, paramètres) a été réalisé.
- Les transactions des deux versions ont été comparées ligne à ligne, et chaque écart est expliqué (données ou code).
- Les écarts dus au code ont été corrigés.
- L’EA a été testé dans un mode de modélisation plus exigeant (ticks réels si disponibles) et avec des délais d’exécution simulés.
- L’EA a fonctionné en démonstration pendant une période suffisante, sur le type de compte réel, incluant des séances agitées.
Voir Testeur MT4 contre testeur MT5.
7. Déploiement
- Le trading automatique est autorisé dans le terminal MT5 et dans les propriétés de l’EA.
- Les paramètres de production sont enregistrés dans un fichier de réglages et documentés.
- L’EA affiche un état clair au démarrage (autorisation, mode du compte, symbole) et prévient en cas de blocage.
- Les positions éventuellement ouvertes par l’ancienne version MQL4 sur un autre compte ont été gérées : l’EA MQL5 ne les connaît pas.
- La version MQL4 de référence est archivée avec son backtest, pour toute comparaison ultérieure.
- Une surveillance est en place pendant les premières semaines : journal, notifications, comparaison avec les résultats de démonstration.
Les habitudes de déploiement prises sur MT4, comme l’hébergement sur un serveur distant, sont décrites dans Faire tourner un EA MT4 sur VPS ; elles s’appliquent de la même manière à MetaTrader 5.
Utiliser la checklist en équipe
Si plusieurs personnes interviennent sur la migration, attribuez chaque section à un responsable et conservez la liste cochée avec le code source. Un relecteur qui n’a pas écrit le portage repère plus facilement les oublis, en particulier dans les sections 2 et 3, où les erreurs ne produisent aucun message de compilation. Pour un développeur seul, laisser passer une journée entre le portage et la relecture avec la liste produit un effet comparable.
Questions fréquentes
Par quelle section commencer ?
Par la préparation dans MQL4. Chaque modification faite et testée côté MQL4 est une source d’écart de moins à analyser côté MQL5.
Quels sont les oublis les plus fréquents ?
Le comptage des positions avec OrdersTotal(), le décalage d’indice dans CopyBuffer ou CopyRates, l’absence de test du code de retour après un envoi, et l’oubli du mode netting.
Combien de temps tester en démonstration ?
Assez longtemps pour que l’EA ait rencontré un nombre significatif de trades et des conditions variées, y compris des séances agitées. La durée dépend donc de la fréquence de trading de la stratégie.
La checklist s’applique-t-elle aux indicateurs personnalisés ?
En grande partie : les sections sur les séries, les propriétés, les handles et les tests s’appliquent aussi. Les sections sur le trading et les codes de retour ne concernent que les EA.
