MQL5 · Expert Advisors
Détecter une nouvelle bougie en MQL5 : exécuter la logique une fois par barre
Comment exécuter la logique d’un Expert Advisor MQL5 une seule fois par bougie : méthode par l’heure d’ouverture, fonction réutilisable multi-unités de temps et pièges du premier tick.
Pour détecter une nouvelle bougie en MQL5, mémorisez l’heure d’ouverture de la barre courante, obtenue avec iTime(_Symbol, _Period, 0), puis comparez-la à chaque tick avec la valeur mémorisée : si elle a changé, une nouvelle barre vient de s’ouvrir et vous exécutez votre logique une seule fois. Cette technique est indispensable parce que OnTick est appelé à chaque variation de prix, parfois plusieurs dizaines de fois par seconde, alors que la plupart des stratégies ne doivent décider qu’à la clôture d’une bougie.
Cette page de la rubrique Construire un Expert Advisor en MQL5 compare les méthodes de détection, fournit une fonction réutilisable et liste les pièges qui produisent des ordres en double ou des signaux manqués.
Pourquoi un EA a besoin de détecter une nouvelle barre
Imaginons un EA qui achète lorsque la moyenne rapide passe au-dessus de la moyenne lente. Si la condition est évaluée à chaque tick sur la bougie en cours, trois problèmes apparaissent :
- Ordres multiples : tant que la condition reste vraie, chaque tick déclenche une nouvelle tentative d’achat.
- Signaux instables : sur la bougie en formation, le croisement peut apparaître puis disparaître avant la clôture. L’EA entre sur un signal qui, une fois la bougie fermée, n’a jamais existé.
- Divergence avec le backtest : un EA qui décide à chaque tick dépend fortement du mode de modélisation des ticks, ce qui rend les résultats du testeur moins représentatifs.
En limitant la décision au premier tick de chaque nouvelle barre et en lisant les données de la barre clôturée (index 1), vous obtenez une logique stable et reproductible. C’est l’approche adoptée dans la page Coder un signal d’entrée.
Les méthodes possibles
| Méthode | Principe | Fiabilité |
|---|---|---|
| Heure d’ouverture de la barre 0 | comparer iTime(..., 0) à la valeur mémorisée | bonne, méthode recommandée |
| Nombre de barres | comparer Bars(symbole, période) au nombre mémorisé | moyenne : le nombre change aussi quand de l’historique est chargé ou quand le terminal limite le nombre de barres |
| Volume en ticks égal à 1 | considérer qu’une barre est nouvelle si elle n’a reçu qu’un tick | faible : si le premier tick de la barre est manqué, la nouvelle barre n’est jamais détectée |
| Minuterie | vérifier l’heure à intervalle régulier dans OnTimer | utile pour les EA multi-symboles, voir plus bas |
La méthode par l’heure d’ouverture est la plus robuste car elle ne dépend ni du nombre de ticks reçus, ni de la profondeur de l’historique. iTime renvoie l’heure d’ouverture de la barre demandée, ou 0 en cas d’erreur, ce qui arrive notamment quand les données de la série ne sont pas encore prêtes.
Une fonction réutilisable
La fonction ci-dessous fonctionne pour n’importe quel symbole et n’importe quelle unité de temps. Elle mémorise la dernière heure vue dans une variable passée par référence, ce qui permet d’avoir plusieurs détecteurs indépendants dans un même EA (par exemple un pour la barre H1 et un pour la barre journalière).
//+------------------------------------------------------------------+
//| Renvoie true une seule fois par nouvelle barre |
//| last_time : variable mémorisant l'heure de la dernière barre vue |
//+------------------------------------------------------------------+
bool IsNewBar(const string symbol, const ENUM_TIMEFRAMES tf, datetime &last_time)
{
datetime current = iTime(symbol, tf, 0); // heure d'ouverture de la barre en cours
if(current == 0) // données pas encore disponibles
return(false);
if(current == last_time) // même barre que lors du dernier appel
return(false);
last_time = current; // mémoriser la nouvelle barre
return(true);
}
//--- variables globales : une par détecteur
datetime g_lastBarH1 = 0;
datetime g_lastBarD1 = 0;
int OnInit()
{
//--- option : ne pas traiter la barre en cours au démarrage
g_lastBarH1 = iTime(_Symbol, PERIOD_H1, 0);
g_lastBarD1 = iTime(_Symbol, PERIOD_D1, 0);
return(INIT_SUCCEEDED);
}
void OnTick()
{
//--- tâche quotidienne : par exemple remettre à zéro un compteur
if(IsNewBar(_Symbol, PERIOD_D1, g_lastBarD1))
Print("Nouvelle journée de trading : ", TimeToString(g_lastBarD1));
//--- logique de trading : une seule fois par bougie H1
if(!IsNewBar(_Symbol, PERIOD_H1, g_lastBarH1))
return;
Print("Nouvelle bougie H1 ouverte à ", TimeToString(g_lastBarH1));
//--- ici : lire les données de la bougie clôturée (index 1) et décider
}
Initialiser ou non la date au démarrage
Le choix fait dans OnInit change le comportement au lancement. Si vous laissez la variable à 0, la première exécution d’OnTick est considérée comme une nouvelle barre : l’EA évalue immédiatement le signal de la dernière bougie clôturée, même si elle s’est fermée il y a cinquante minutes. Si vous initialisez la variable avec l’heure de la barre en cours, l’EA attend l’ouverture de la barre suivante. La seconde option est généralement plus prudente : elle évite d’entrer en retard sur un signal ancien après un redémarrage du terminal.
Les pièges à connaître
Le premier tick de la barre peut arriver tard
Une barre H1 s’ouvre « officiellement » à l’heure pile, mais OnTick n’est appelé qu’à l’arrivée d’un tick. Sur un marché calme, le premier tick peut arriver plusieurs secondes, voire minutes, après l’heure théorique. Pendant les week-ends et les jours fériés, aucune barre ne s’ouvre. Ne supposez donc jamais que la nouvelle barre est détectée exactement à l’heure ronde.
Une barre peut être sautée
Si aucun tick n’arrive pendant toute la durée d’une barre (fréquent en M1 sur un marché peu liquide), cette barre n’existe tout simplement pas dans l’historique. La fonction détectera directement la barre suivante. Si votre logique compte les barres pour mesurer une durée, utilisez plutôt des écarts de temps.
Les données de la barre précédente doivent être prêtes
Au premier tick d’une nouvelle barre, les indicateurs sont recalculés. Si CopyBuffer renvoie -1 ou moins de valeurs que demandé, ne marquez pas la barre comme traitée sans avoir agi : une variante robuste consiste à ne mettre à jour la date mémorisée qu’après une lecture réussie des données.
La détection est par graphique, pas par symbole
OnTick n’est appelé que pour les ticks du symbole du graphique. Si vous surveillez la barre d’un autre symbole, la détection ne se fait qu’au prochain tick du symbole principal. Pour un robot multi-instruments, la vérification périodique via une minuterie est plus fiable : voir EA multi-symboles et Utiliser OnTimer.
Le changement d’unité de temps recharge l’EA
Changer l’unité de temps du graphique provoque un OnDeinit puis un OnInit : les variables globales sont réinitialisées. Avec l’initialisation au démarrage recommandée plus haut, l’EA ne retraitera pas la barre en cours.
Cas d’usage en trading
- Stratégies sur clôture : croisements, cassures de plus haut ou plus bas, figures de chandeliers. La décision se prend au premier tick de la nouvelle barre, sur les valeurs de la barre 1.
- Gestion par barre : déplacer un stop suiveur une fois par bougie plutôt qu’à chaque tick réduit le nombre de requêtes envoyées au serveur. Le principe du stop suiveur est expliqué dans Coder un trailing stop.
- Tâches quotidiennes : la détection d’une nouvelle barre D1 permet de remettre à zéro un compteur de trades ou une limite de perte journalière. Notez que la barre D1 suit l’heure du serveur du courtier, pas votre heure locale.
Questions fréquentes
Pourquoi mon EA ouvre-t-il plusieurs positions sur la même bougie ?
Parce que la condition d’entrée est évaluée à chaque tick tant qu’elle reste vraie. Placez la détection de nouvelle barre au début d’OnTick et vérifiez en plus qu’aucune position portant votre magic number n’est déjà ouverte.
La détection fonctionne-t-elle dans le Strategy Tester ?
Oui. Le testeur génère des ticks et l’heure d’ouverture des barres évolue comme en réel. En mode « prix d’ouverture uniquement », l’EA ne reçoit de toute façon qu’un tick par barre, mais garder la détection rend le code valable dans tous les modes.
Faut-il utiliser l’index 0 ou l’index 1 pour lire les données après une nouvelle barre ?
L’index 0 désigne la barre qui vient de s’ouvrir et qui ne contient qu’un ou quelques ticks. Pour décider sur une bougie terminée, lisez l’index 1 (et l’index 2 pour une comparaison avec la bougie précédente).
Comment détecter une nouvelle bougie sur une autre unité de temps que celle du graphique ?
Passez l’unité de temps souhaitée à iTime, par exemple PERIOD_H4, avec une variable de mémorisation dédiée. La détection a lieu au premier tick du symbole du graphique qui suit l’ouverture de la barre H4.
- Structure d’un Expert Advisor
- Coder un signal d’entrée
- Filtres horaires, de spread et de volatilité
- Intégrer la gestion du risque
- Limite de perte journalière
- EA multi-symboles
- Utiliser OnTimer
- Variables globales du terminal
- Sauvegarder l’état dans des fichiers
- Alertes, e-mails et notifications push
- Panneaux et boutons (CAppDialog)
- L’assistant MQL5 (MQL5 Wizard)
- Déployer un EA sur VPS
- Checklist avant mise en production
