MQL4 · Bases
Les bases du MQL4 : structure, données de marché et outils
Structure d’un EA, variables prédéfinies, tableaux de séries, mode strict, MetaEditor et débogage : les fondations du MQL4 à maîtriser avant de gérer le moindre ordre sur MetaTrader 4.
Le MQL4 est le langage des Expert Advisors, indicateurs et scripts de MetaTrader 4. Ses bases tiennent en peu de notions, mais elles diffèrent assez du MQL5 pour piéger un développeur pressé : des variables prédéfinies comme Bid, Ask ou Point, des tableaux de séries Close[] et Time[] accessibles directement, un mode de compilation #property strict qui change le comportement du code, et une fonction RefreshRates() sans équivalent dans MetaTrader 5. Cette rubrique rassemble tout ce qu’il faut maîtriser avant d’écrire la moindre ligne de gestion d’ordres.
Chaque page traite une seule question, avec un exemple de code compilable et les pièges que l’on rencontre réellement sur un compte de trading. L’objectif n’est pas de réciter la documentation, mais de vous permettre de lire et d’écrire un EA MQL4 propre, que vous pourrez ensuite maintenir ou porter vers MQL5.
Pourquoi commencer par les bases quand on vise un robot de trading
La majorité des robots MQL4 qui « ne marchent pas » ne souffrent pas d’une mauvaise stratégie, mais d’erreurs de fondation : un prix lu avant d’avoir été rafraîchi, une distance exprimée en points alors que l’auteur pensait en pips, un tableau de séries lu à un indice qui n’existe pas encore, un paramètre déclaré avec extern que le code modifie par mégarde. Ces défauts ne se voient pas toujours dans le testeur de stratégie ; ils apparaissent en réel, au pire moment.
Les pages qui suivent couvrent trois blocs :
- le squelette d’un programme : fonctions d’événement, paramètres d’entrée, mode strict ;
- l’accès aux données de marché : variables prédéfinies, tableaux de séries, rafraîchissement des cotations, gestion du temps ;
- l’outillage : MetaEditor, compilation, installation et débogage.
Une fois ce socle acquis, la rubrique Gérer les ordres en MQL4 prend le relais avec OrderSend(), OrderModify(), OrderSelect() et la gestion du risque par ordre.
Ordre de lecture conseillé
Si vous découvrez le langage, suivez cet ordre. Il va du plus structurant au plus pratique et évite de rencontrer une notion avant qu’elle ait été expliquée.
- Structure d’un EA MQL4 : les fonctions
OnInit(),OnTick()etOnDeinit(), ce qu’il faut mettre dans chacune. - extern et input : déclarer les paramètres que l’utilisateur réglera dans la fenêtre des propriétés.
- #property strict : comprendre le mode de compilation recommandé et ce qu’il change.
- Variables prédéfinies :
Bid,Ask,Point,Digits,Barset leurs limites. - Tableaux de séries : lire
Close[],High[],Time[]et passer aux fonctionsiClose()ouiTime()pour d’autres symboles. - RefreshRates : savoir quand les cotations en mémoire deviennent obsolètes.
- Fonctions de temps : heure du serveur, heure locale, filtres horaires.
- MetaEditor pour MQL4 : l’environnement de travail.
- Compiler et installer un EA MQL4 : du fichier .mq4 au robot attaché au graphique.
- Déboguer en MQL4 : journal,
Print(), points d’arrêt et lecture des erreurs.
Si vous programmez déjà en MQL5, commencez plutôt par les variables prédéfinies, les tableaux de séries et RefreshRates() : ce sont les trois notions qui n’existent pas sous cette forme dans MetaTrader 5.
Les pages de la rubrique
Le squelette d’un programme
- Structure d’un EA MQL4 : les directives
#property, les paramètres, les variables globales et les trois fonctions d’événement principales, avec un modèle commenté prêt à compléter. - extern et input : la différence entre un paramètre modifiable par le code et un paramètre en lecture seule, les commentaires affichés dans la fenêtre des propriétés et les énumérations.
- #property strict : portée des variables, initialisation, retour obligatoire des fonctions, dépassement de tableau devenu erreur critique ; pourquoi ce mode doit figurer en tête de tout nouveau fichier.
Les données de marché
- Variables prédéfinies (Bid, Ask, Point, Digits) : ce que contient chaque variable, pourquoi elle ne vaut que pour le symbole du graphique et comment convertir points et pips sur les cotations à 3 ou 5 décimales.
- [Tableaux de séries (Close[], Time[])](/mql4/bases/tableaux-de-series/) : l’indexation inversée, la bougie 0 encore en formation, les fonctions
iClose(),iTime(),iBarShift()etiHighest(). - RefreshRates : quand et pourquoi rafraîchir les variables prédéfinies, notamment dans une boucle de tentatives d’envoi d’ordre.
- Fonctions de temps :
TimeCurrent(),TimeLocal(),TimeHour(),TimeDayOfWeek(),TimeToStruct()et la construction d’un filtre de session.
L’outillage
- MetaEditor pour MQL4 : l’arborescence du dossier MQL4, l’assistant de création, la boîte à outils et les raccourcis utiles.
- Compiler et installer un EA MQL4 : produire le fichier .ex4, lire les erreurs et avertissements, placer le robot sur un graphique et autoriser le trading.
- Déboguer en MQL4 :
Print(),Comment(),GetLastError(), le débogueur de MetaEditor et une méthode pour isoler un bug sans y passer la nuit.
MQL4 ou MQL5 : faut-il encore apprendre les bases du MQL4 ?
MetaTrader 4 reste très répandu chez les courtiers et dans les bibliothèques de robots existants. Savoir lire et corriger du MQL4 est donc utile, même si vous comptez développer vos nouveaux projets en MQL5. Les deux langages partagent la syntaxe héritée du C++, les types de base et les fonctions d’événement, mais divergent sur l’accès aux prix, aux indicateurs et surtout aux ordres.
Le tableau ci-dessous résume les écarts que vous rencontrerez dans cette rubrique.
| Notion | MQL4 | MQL5 |
|---|---|---|
| Prix courant | Bid, Ask | SymbolInfoDouble() ou SymbolInfoTick() |
| Historique des bougies | Close[i], Time[i] | CopyClose(), CopyRates() ou iClose() |
| Rafraîchir les cotations | RefreshRates() | pas d’équivalent direct, on relit le tick |
| Paramètres | extern ou input | input et sinput |
| Mode strict | #property strict optionnel | comportement strict par défaut |
Pour un comparatif complet et une méthode de conversion, consultez la rubrique Migration de MQL4 vers MQL5. Si vous partez de zéro sur MetaTrader 5, la rubrique sœur Les bases du MQL5 suit la même logique que celle-ci.
Méthode de travail recommandée
Lire ne suffit pas : chaque notion se fixe en l’essayant. Pour tirer le meilleur de cette rubrique, ouvrez MetaEditor à côté de votre navigateur et appliquez cette routine.
- Un fichier par notion. Créez un petit EA ou un script de test pour chaque page lue. Un script s’exécute une seule fois et affiche son résultat dans le journal : c’est l’outil idéal pour observer
Point,DigitsouTime[0]sans attendre un tick. - Compte de démonstration uniquement. Tant que vous apprenez, ne branchez jamais un EA expérimental sur un compte réel. Les erreurs de base se paient en argent.
- Journal ouvert en permanence. L’onglet Experts du terminal et l’onglet Journal du testeur sont vos meilleurs alliés : prenez l’habitude d’y afficher les valeurs intermédiaires.
- Strict dès le départ. Ajoutez
#property strictà tous vos fichiers. Le compilateur vous signalera plus tôt les erreurs qui, sinon, se transforment en comportements silencieux.
Quand ces réflexes sont en place, passez à la création de votre premier EA, qui assemble ces notions dans un robot complet.
FAQ
Le MQL4 est-il plus simple que le MQL5 ?
Pour démarrer, oui : les prix et l’historique sont accessibles directement par des variables et des tableaux prédéfinis, et la gestion des ordres passe par quelques fonctions courtes. En contrepartie, le langage offre moins de garde-fous et de fonctions récentes. Les deux partagent l’essentiel de la syntaxe, ce qui rend la transition assez naturelle.
Un EA MQL4 fonctionne-t-il dans MetaTrader 5 ?
Non. Un fichier .ex4 ne se charge pas dans MetaTrader 5 et le code source .mq4 ne compile pas tel quel en MQL5, notamment à cause des fonctions de trading et d’indicateurs. Il faut le convertir ; la rubrique migration détaille la méthode.
Faut-il toujours écrire #property strict ?
Pour tout nouveau code, oui. Le mode strict rend le compilateur plus exigeant et transforme certains dépassements de tableau en erreurs critiques visibles, ce qui évite des bugs silencieux. Sur un ancien code, l’activer peut faire apparaître des erreurs de compilation qu’il faudra corriger une à une.
Dans quel ordre lire les pages si je connais déjà MQL5 ?
Concentrez-vous sur les variables prédéfinies, les tableaux de séries, RefreshRates et extern contre input. Le reste (structure, MetaEditor, compilation) vous sera familier.
