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

MQL5 · Expert Advisors

Utiliser OnTimer dans un Expert Advisor MQL5 : EventSetTimer et tâches périodiques

Déclencher des traitements à intervalle régulier dans un EA MQL5, même sans tick, avec EventSetTimer, EventSetMillisecondTimer et EventKillTimer : règles de fonctionnement, exemple multi-tâches et pièges courants.

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

OnTimer est la fonction qu’un Expert Advisor MQL5 exécute à intervalle régulier, indépendamment de l’arrivée des ticks. Pour l’activer, appelez EventSetTimer(secondes) dans OnInit (ou EventSetMillisecondTimer(millisecondes) pour une période inférieure à la seconde), écrivez votre traitement dans void OnTimer(), puis arrêtez la minuterie avec EventKillTimer() dans OnDeinit. La minuterie sert aux tâches qui ne doivent pas dépendre de l’activité du marché : surveillance de plusieurs symboles, contrôles de sécurité, sauvegarde d’état, rapports périodiques.

Cette page de la rubrique Construire un Expert Advisor en MQL5 explique les règles de fonctionnement de la minuterie, montre comment faire cohabiter plusieurs tâches périodiques avec une seule minuterie, et liste les pièges courants. La liste complète des fonctions événementielles est présentée dans Les fonctions événementielles.

Les fonctions de la minuterie

FonctionSignatureRôle
EventSetTimerbool EventSetTimer(int seconds)lance une minuterie dont la période est exprimée en secondes
EventSetMillisecondTimerbool EventSetMillisecondTimer(int milliseconds)lance une minuterie dont la période est exprimée en millisecondes
EventKillTimervoid EventKillTimer()arrête la minuterie du programme
OnTimervoid OnTimer()fonction appelée à chaque échéance

Les deux fonctions de lancement renvoient true en cas de succès et false en cas d’échec ; GetLastError() donne alors la cause. Un EA qui dépend de la minuterie doit vérifier ce retour dans OnInit et refuser de démarrer si la minuterie n’a pas pu être créée.

Les règles à connaître

Une seule minuterie par programme

Chaque EA ou indicateur dispose de sa propre minuterie et ne reçoit que ses propres événements. En revanche, un programme ne peut faire tourner qu’une seule minuterie à la fois. Si vous avez besoin de tâches à des rythmes différents (toutes les secondes, toutes les minutes, toutes les heures), utilisez une minuterie au rythme le plus rapide et des compteurs ou des dates de dernière exécution pour cadencer les tâches plus lentes, comme dans l’exemple ci-dessous.

Les événements ne s’accumulent pas

Si un événement de minuterie est déjà en file d’attente ou en cours de traitement, le terminal n’en ajoute pas un nouveau. Conséquence : si OnTimer dure plus longtemps que la période, des échéances sont simplement sautées. Ne comptez donc pas les appels pour mesurer le temps écoulé ; comparez plutôt des dates.

La résolution est limitée

En temps réel, les événements de minuterie ne peuvent pas être générés plus souvent qu’une fois toutes les 10 à 16 millisecondes, en raison de limites matérielles. Une minuterie à 1 milliseconde ne fonctionnera donc pas à ce rythme. Pour la quasi-totalité des EA, une période d’une seconde ou plus suffit.

La minuterie est détruite à l’arrêt

Si l’EA s’arrête sans avoir appelé EventKillTimer, le terminal détruit la minuterie. Appeler explicitement EventKillTimer dans OnDeinit reste une bonne pratique : le code exprime clairement son cycle de vie, et la règle est indispensable si la minuterie est lancée dans le constructeur d’une classe (arrêtez-la alors dans le destructeur).

Le temps dans OnTimer

TimeCurrent() renvoie l’heure du dernier tick connu. Lorsque le marché est fermé ou très calme, cette valeur n’avance plus, alors que OnTimer continue d’être appelé. Pour cadencer des tâches, utilisez une horloge qui avance toujours, comme TimeLocal() (heure de l’ordinateur) ou TimeTradeServer() (heure estimée du serveur). Les différences entre ces fonctions sont expliquées dans Dates, heures et fuseaux.

Exemple : plusieurs tâches avec une seule minuterie

L’EA ci-dessous lance une minuterie d’une seconde. Toutes les secondes, il vérifie la connexion ; toutes les minutes, il contrôle que des cotations arrivent ; toutes les heures, il écrit un bilan dans le journal.

#property version "1.00"

input int InpStaleSeconds = 120;   // délai sans tick au-delà duquel on s'inquiète

datetime g_lastMinuteTask = 0;
datetime g_lastHourTask   = 0;
bool     g_wasConnected   = true;

int OnInit()
  {
   if(!EventSetTimer(1))                       // une échéance par seconde
     {
      Print("Minuterie impossible, erreur ", GetLastError());
      return(INIT_FAILED);
     }
   return(INIT_SUCCEEDED);
  }

void OnDeinit(const int reason)
  {
   EventKillTimer();                           // arrêt explicite de la minuterie
  }

void OnTimer()
  {
   datetime now = TimeLocal();                 // horloge qui avance même sans tick

   //--- tâche 1 (chaque seconde) : changement d'état de la connexion
   bool connected = (bool)TerminalInfoInteger(TERMINAL_CONNECTED);
   if(connected != g_wasConnected)
     {
      Print(connected ? "Connexion rétablie" : "Connexion au serveur perdue");
      g_wasConnected = connected;
     }

   //--- tâche 2 (chaque minute) : les cotations arrivent-elles ?
   if(now - g_lastMinuteTask >= 60)
     {
      g_lastMinuteTask = now;
      MqlTick tick;
      if(SymbolInfoTick(_Symbol, tick))
        {
         long age = (long)(TimeTradeServer() - tick.time);
         if(age > InpStaleSeconds)
            PrintFormat("%s : aucun tick depuis %I64d s (marché fermé ou flux interrompu)", _Symbol, age);
        }
     }

   //--- tâche 3 (chaque heure) : bilan dans le journal
   if(now - g_lastHourTask >= 3600)
     {
      g_lastHourTask = now;
      PrintFormat("Bilan : capitaux propres %.2f, positions ouvertes %d",
                  AccountInfoDouble(ACCOUNT_EQUITY), PositionsTotal());
     }
  }

void OnTick()
  {
   //--- la logique de trading reste ici, déclenchée par les ticks
  }

Lecture du code

  • Une seule minuterie, trois rythmes : chaque tâche lente mémorise la date de sa dernière exécution et compare l’écart à sa période.
  • Les dates sont initialisées à 0 : les tâches 2 et 3 s’exécutent donc dès la première seconde, ce qui permet de vérifier immédiatement leur bon fonctionnement.
  • La logique de trading reste dans OnTick. Rien n’interdit de trader depuis OnTimer (c’est le cas des EA multi-symboles), mais séparer la surveillance de la décision rend l’EA plus lisible.

OnTimer et OnTick dans le même EA

Chaque programme possède sa propre file d’événements, traitée dans l’ordre d’arrivée : OnTick et OnTimer ne s’exécutent jamais en même temps dans un même EA. Vous n’avez donc pas à protéger les variables globales contre des accès simultanés entre ces deux fonctions. En contrepartie, un traitement long dans l’une retarde l’autre. Si OnTimer et OnTick partagent une décision (par exemple un drapeau « trading suspendu »), écrivez-la dans une variable globale lue par les deux : c’est simple et sans risque de conflit.

Cas d’usage en trading

  • EA multi-symboles : parcourir la liste des instruments et détecter les nouvelles bougies de chacun, sans dépendre des ticks du graphique. Voir EA multi-symboles.
  • Gestion à heure fixe : fermer les positions avant le week-end ou avant la clôture d’un indice, même si aucun tick n’arrive au moment voulu.
  • Sauvegarde périodique : écrire l’état de l’EA sur disque toutes les minutes, comme décrit dans Sauvegarder l’état dans des fichiers.
  • Surveillance : contrôler la connexion, l’âge des cotations, l’autorisation de trading, et prévenir l’opérateur en cas d’anomalie.
  • Rafraîchissement d’interface : mettre à jour un panneau d’informations à un rythme fixe plutôt qu’à chaque tick.

Pièges fréquents

  • Oublier de vérifier le retour d’EventSetTimer. Sans minuterie, un EA multi-symboles ne fait plus rien, sans aucun message.
  • Utiliser TimeCurrent pour cadencer. Le week-end, TimeCurrent() reste figé sur le dernier tick du vendredi : une tâche horaire basée sur cette valeur ne s’exécute plus.
  • Un traitement trop long. Un OnTimer qui parcourt tout l’historique du compte chaque seconde ralentit le terminal et retarde aussi le traitement des ticks, puisque les événements d’un même programme sont traités l’un après l’autre.
  • Une période trop courte dans le Strategy Tester. Le testeur appelle OnTimer selon la période demandée : une minuterie rapide augmente nettement la durée des tests. Adaptez la période si le traitement ne nécessite pas une telle fréquence.
  • Appeler EventSetTimer deux fois. Il n’existe qu’une minuterie par programme : un second appel ne crée pas une seconde minuterie. Concevez dès le départ une minuterie unique cadençant plusieurs tâches.

Questions fréquentes

OnTimer est-il appelé quand le marché est fermé ?

Oui, tant que le terminal tourne et que l’EA est actif, la minuterie continue de générer des événements, même sans tick. C’est justement ce qui la rend utile pour la surveillance.

Peut-on changer la période de la minuterie en cours de route ?

Oui : arrêtez la minuterie avec EventKillTimer, puis relancez-la avec la nouvelle période. Gardez cependant à l’esprit qu’il n’existe qu’une minuterie par programme.

OnTimer fonctionne-t-il dans le Strategy Tester ?

Oui. Le testeur génère les événements de minuterie selon le temps simulé. Plus la période est courte, plus le test est long, car OnTimer est appelé plus souvent.

Faut-il préférer OnTimer à OnTick pour un EA mono-symbole ?

Pas forcément. Pour une stratégie qui réagit aux prix d’un seul instrument, OnTick est le déclencheur naturel. La minuterie est utile en complément, pour les tâches qui doivent s’exécuter même sans tick.

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.