MQL5 · Expert Advisors
Coder une limite de perte journalière dans un Expert Advisor MQL5
Un coupe-circuit qui mesure le résultat réalisé et latent de la journée, bloque les entrées au-delà d’un seuil et survit au redémarrage du terminal grâce aux variables globales.
Une limite de perte journalière est un coupe-circuit codé dans l’Expert Advisor : l’EA calcule en permanence son résultat de la journée, réalisé (positions fermées) et latent (positions ouvertes), et cesse d’ouvrir de nouvelles positions dès que la perte atteint un seuil fixé, par exemple 2 % du capital de début de journée. Selon votre choix, il peut aussi fermer immédiatement ses positions ouvertes. Le blocage se lève automatiquement au début de la journée de trading suivante, définie par l’heure du serveur.
Cette page de la rubrique Construire un Expert Advisor en MQL5 montre comment mesurer ce résultat avec l’historique des transactions, mémoriser le capital de référence pour qu’il survive à un redémarrage, et déclencher l’arrêt de façon fiable. La logique de fixation du seuil est traitée côté méthode dans Limites de perte journalière.
Pourquoi une limite journalière dans le code
Le dimensionnement par trade, décrit dans Intégrer la gestion du risque, borne la perte de chaque position. Il ne protège pas contre une accumulation de pertes dans une même séance : un régime de marché inhabituel, une série de faux signaux, un bug qui ouvre des positions en boucle ou un flux de prix erroné. Une limite journalière ajoute une seconde barrière, indépendante du signal. Elle a aussi un intérêt opérationnel : un EA qui s’est arrêté pour cause de limite atteinte est un signal d’alerte qui mérite que vous examiniez la journée avant de le laisser repartir.
Les choix de conception
Avant d’écrire le code, quatre décisions doivent être prises explicitement.
| Question | Options | Recommandation |
|---|---|---|
| Quelle base pour le pourcentage ? | solde ou capitaux propres au début de la journée | capitaux propres de début de journée, mémorisés |
| Quel périmètre ? | les seules positions de l’EA, ou tout le compte | les positions de l’EA (magic number), sauf si vous voulez un garde-fou de compte |
| Que compter ? | perte réalisée seule, ou réalisée + latente | réalisée + latente, sinon une grosse position perdante ouverte ne déclenche rien |
| Que faire au seuil ? | bloquer les entrées, ou bloquer et fermer | bloquer toujours ; fermer selon la stratégie |
Cohérence avec le risque par trade
Le seuil journalier se raisonne en nombre de pertes complètes. Avec un risque de 0,5 % par trade, une limite de 2 % autorise quatre pertes au stop dans la journée. Une limite inférieure au risque d’un seul trade n’a pas de sens : elle se déclencherait sur la première position perdante, avant même le stop. Fixez donc les deux paramètres ensemble et vérifiez dans OnInit que la limite journalière reste supérieure au risque par trade.
Quand commence la journée ?
La journée de trading de MetaTrader suit l’heure du serveur du courtier. L’heure d’ouverture de la bougie journalière en cours, iTime(_Symbol, PERIOD_D1, 0), donne directement le début de cette journée. Utiliser cette valeur plutôt que minuit à votre heure locale garantit que la limite se réinitialise en même temps que les bougies D1 de vos graphiques.
Mesurer le résultat de la journée
Le résultat réalisé
HistorySelect(début, fin) charge l’historique des ordres et des transactions (deals) de la période. On parcourt ensuite les transactions avec HistoryDealsTotal() et HistoryDealGetTicket(i), comme expliqué dans Lire l’historique des ordres et transactions. Pour chaque transaction de l’EA (propriété DEAL_MAGIC), le résultat est la somme de DEAL_PROFIT, DEAL_SWAP, DEAL_COMMISSION et DEAL_FEE. Les commissions peuvent être portées par les transactions d’entrée comme de sortie : on additionne donc toutes les transactions de l’EA, quel que soit leur sens.
Le résultat latent
Pour les positions encore ouvertes, PositionGetDouble(POSITION_PROFIT) et POSITION_SWAP donnent le résultat flottant. Additionné au réalisé, on obtient le résultat de la journée tel qu’il serait si tout était fermé maintenant (aux frais de sortie près).
Mémoriser le capital de référence
Si le terminal redémarre en cours de journée, une variable globale du programme repart à zéro. Le capital de début de journée est donc conservé dans une variable globale du terminal, dont le nom inclut le numéro de compte et le magic number pour éviter toute collision entre EA.
Code complet
#property version "1.00"
#include <Trade\Trade.mqh>
input double InpDailyLossPct = 2.0; // perte journalière maximale en %
input bool InpCloseOnLimit = true; // fermer les positions au déclenchement
sinput ulong InpMagic = 260106;
CTrade trade;
datetime g_dayStart = 0; // début de la journée serveur en cours
double g_dayEquity = 0.0; // capitaux propres de référence
bool g_halted = false; // limite atteinte aujourd'hui
string GvName() // nom unique : compte + magic
{
return(StringFormat("DLL_%I64d_%I64u", AccountInfoInteger(ACCOUNT_LOGIN), InpMagic));
}
//--- détecte le changement de jour et (re)charge le capital de référence
void UpdateDay()
{
datetime d = iTime(_Symbol, PERIOD_D1, 0);
if(d == 0 || d == g_dayStart) return;
g_dayStart = d;
g_halted = false;
string gv = GvName();
//--- deux variables : date de la journée (_d) et capital de référence (_e)
if(GlobalVariableCheck(gv + "_d") && (datetime)GlobalVariableGet(gv + "_d") == d)
g_dayEquity = GlobalVariableGet(gv + "_e"); // redémarrage en cours de journée
else
{
g_dayEquity = AccountInfoDouble(ACCOUNT_EQUITY); // nouvelle journée
GlobalVariableSet(gv + "_d", (double)d);
GlobalVariableSet(gv + "_e", g_dayEquity);
}
PrintFormat("Journée du %s, capital de référence %.2f", TimeToString(d), g_dayEquity);
}
//--- résultat réalisé + latent de l'EA depuis le début de la journée
double DailyResult()
{
double result = 0.0;
if(HistorySelect(g_dayStart, TimeCurrent() + 60)) // marge pour la seconde en cours
{
for(int i = HistoryDealsTotal() - 1; i >= 0; i--)
{
ulong t = HistoryDealGetTicket(i);
if(t == 0 || HistoryDealGetInteger(t, DEAL_MAGIC) != (long)InpMagic) continue;
result += HistoryDealGetDouble(t, DEAL_PROFIT) + HistoryDealGetDouble(t, DEAL_SWAP)
+ HistoryDealGetDouble(t, DEAL_COMMISSION) + HistoryDealGetDouble(t, DEAL_FEE);
}
}
for(int i = PositionsTotal() - 1; i >= 0; i--)
{
if(PositionGetTicket(i) == 0 || PositionGetInteger(POSITION_MAGIC) != (long)InpMagic) continue;
result += PositionGetDouble(POSITION_PROFIT) + PositionGetDouble(POSITION_SWAP);
}
return(result);
}
void CloseAllMine()
{
for(int i = PositionsTotal() - 1; i >= 0; i--)
{
ulong t = PositionGetTicket(i);
if(t == 0 || PositionGetInteger(POSITION_MAGIC) != (long)InpMagic) continue;
if(!trade.PositionClose(t))
Print("Fermeture impossible du ticket ", t, " : ", trade.ResultRetcode());
}
}
//--- à appeler en tête de OnTick ; renvoie false si les entrées sont interdites
bool DailyLimitOk()
{
UpdateDay();
if(g_halted) return(false);
double limit = g_dayEquity * InpDailyLossPct / 100.0;
double res = DailyResult();
if(res > -limit) return(true);
g_halted = true;
PrintFormat("Limite journalière atteinte : %.2f (seuil -%.2f)", res, limit);
if(InpCloseOnLimit) CloseAllMine();
return(false);
}
int OnInit()
{
if(InpDailyLossPct <= 0.0 || InpDailyLossPct > 20.0) return(INIT_PARAMETERS_INCORRECT);
trade.SetExpertMagicNumber(InpMagic);
UpdateDay();
return(INIT_SUCCEEDED);
}
void OnTick()
{
if(!DailyLimitOk()) return; // plus aucune entrée aujourd'hui
//--- ici : gestion des positions, filtres, signal, entrée
}
Remarques sur le code
- Le drapeau
g_haltedest réinitialisé dansUpdateDaylors du changement de journée. Après un redémarrage en cours de journée, il repart àfalse, mais le premier appel recalcule le résultat depuis le capital mémorisé : si la limite était atteinte, elle l’est toujours, et le blocage se réactive immédiatement. - Si vous désactivez la fermeture automatique, les positions continuent d’être gérées par leurs stops : vérifiez que le reste de l’EA ne s’interrompt pas lui aussi, sinon un stop suiveur cesserait d’être mis à jour.
- Le calcul parcourt l’historique à chaque tick. Sur un compte très actif, appelez
DailyLimitOkune fois par seconde depuis une minuterie plutôt qu’à chaque tick (voir Utiliser OnTimer).
Pièges et cas pratiques
- Les positions ouvertes la veille.
POSITION_PROFITmesure le résultat depuis l’ouverture de la position, pas depuis le début de la journée. Une position déjà perdante la veille pèse donc entièrement sur le résultat du jour, ce qui rend la limite plus stricte que prévu. Si l’EA est seul sur le compte, une mesure plus exacte consiste à comparer directement les capitaux propres courants aux capitaux propres de référence mémorisés : l’écart représente précisément la variation depuis le début de la journée, frais compris. - Plusieurs EA sur le même compte. Chaque EA applique sa limite à ses propres positions. Si vous voulez une limite globale de compte, comptez toutes les transactions sans filtre de magic number, ou utilisez un EA dédié à la surveillance.
- Le Strategy Tester. Le testeur vérifie que la limite se déclenche et se réinitialise chaque jour, mais il ne reproduit pas un redémarrage du terminal en cours de journée. Testez ce scénario en démonstration : lancez l’EA, provoquez une perte, fermez puis rouvrez le terminal, et vérifiez que le capital de référence est bien relu.
- La fermeture peut échouer. Marché fermé, trading désactivé, requote : journalisez chaque échec et faites-vous prévenir (une notification push est le moyen le plus direct).
Questions fréquentes
La limite doit-elle être calculée sur le solde ou sur les capitaux propres ?
Sur les capitaux propres de début de journée, mémorisés une fois. Le solde ignore les positions ouvertes et rendrait la limite aveugle à une perte latente importante.
Que se passe-t-il à minuit heure locale ?
Rien. La journée est définie par la bougie D1 du serveur du courtier ; la réinitialisation a lieu à l’ouverture de cette bougie, qui ne coïncide pas forcément avec votre minuit.
Faut-il fermer les positions quand la limite est atteinte ?
Cela dépend de la stratégie. Fermer garantit que la perte ne s’aggrave pas au-delà du seuil, mais peut couper une position qui aurait atteint son objectif. Bloquer les nouvelles entrées est en revanche indispensable dans tous les cas.
Comment remettre l’EA en route le jour même ?
Supprimez les variables globales correspondantes (touche F3 dans le terminal) puis relancez l’EA : il prendra les capitaux propres actuels comme nouvelle référence. Faites-le seulement après avoir compris pourquoi la limite a été atteinte.
- Structure d’un Expert Advisor
- Détecter une nouvelle bougie
- Coder un signal d’entrée
- Filtres horaires, de spread et de volatilité
- Intégrer la gestion du risque
- 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
