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

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.

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

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() et deinit() ont été remplacées par OnInit(), OnTick() et OnDeinit().
  • 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, Ask ont été remplacés dans MQL4 par SymbolInfoDouble, SymbolInfoInteger ou SymbolInfoTick, sauf la marge requise.
  • Les tableaux Close[], Time[], etc. ont été remplacés par iClose, iTime et 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 via PositionsTotal().
  • Les positions et les ordres en attente sont parcourus dans des boucles distinctes.
  • Le magic number est défini avec SetExpertMagicNumber (si vous utilisez CTrade) ou dans chaque requête.
  • Les tickets sont déclarés en ulong.
  • Les fermetures partielles utilisent PositionClosePartial ou une transaction opposée, en tenant compte du netting.
  • Les calculs sur l’historique commencent par HistorySelect et 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() dans OnDeinit().
  • 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 mode de MQL4 est remplacé par le bon numéro de buffer.
  • Les tableaux de destination sont indexés avec ArraySetAsSeries lorsque le code suppose l’indice 0 sur la bougie la plus récente.
  • Le nombre d’éléments renvoyé par CopyBuffer est 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[] ou Bars ne 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 avec PeriodSeconds().
  • Chaque propriété du symbole est lue avec la fonction du bon type (SymbolInfoDouble ou SymbolInfoInteger).
  • La marge requise est calculée avec OrderCalcMargin.
  • Les appels à RefreshRates() ont été supprimés.
  • Les fonctions Account...() sont remplacées par AccountInfoDouble et AccountInfoInteger.

5. Gestion des erreurs

  • Le résultat de chaque envoi est vérifié par le code de retour (ResultRetcode() ou result.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.

Cocher toutes les cases de cette liste réduit le risque d’erreur de portage, mais ne garantit ni le bon fonctionnement de l’EA en conditions réelles ni des résultats positifs. Le trading sur marge comporte un risque de perte en capital ; n’engagez que des sommes dont la perte est supportable.

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.

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.