MQL5 · Indicateurs
iSAR en MQL5 : le Parabolic SAR comme trailing stop
Lire le Parabolic SAR avec iSAR, comprendre son facteur d’accélération et l’utiliser comme trailing stop automatique des positions d’un Expert Advisor avec la classe CTrade.
iSAR(symbole, unité de temps, pas, maximum) crée un handle vers le Parabolic SAR de MetaTrader 5 ; l’indicateur a un seul buffer, d’index 0, qui contient pour chaque bougie un niveau de prix placé sous le marché en tendance haussière et au-dessus en tendance baissière. Le Parabolic SAR (Stop And Reverse) a été conçu par J. Welles Wilder précisément pour servir de stop suiveur. C’est donc l’angle de cette page : utiliser iSAR non comme un signal d’entrée, mais comme un trailing stop qui déplace automatiquement le stop loss des positions ouvertes par votre EA.
Le calcul du Parabolic SAR
L’aide de MetaTrader 5 donne la formule de mise à jour :
- en position acheteuse :
SAR(i) = SAR(i-1) + ACCELERATION × (HIGH(i-1) - SAR(i-1)) - en position vendeuse :
SAR(i) = SAR(i-1) + ACCELERATION × (LOW(i-1) - SAR(i-1))
À chaque bougie, le SAR se rapproche du prix d’une fraction de l’écart qui les sépare. Cette fraction, le facteur d’accélération, part du pas (step) et augmente de ce même pas chaque fois que le prix établit un nouvel extrême dans le sens de la tendance, sans dépasser le maximum. La documentation de la fonction donne 0,02 et 0,2 comme valeurs typiques. Résultat : au début d’une tendance, le SAR reste loin du prix et monte lentement ; plus la tendance dure et accélère, plus il se resserre. Quand le prix franchit le SAR, l’indicateur change de côté, d’où son nom « stop et retournement ».
Cette mécanique a une conséquence directe : le SAR avance même si le prix stagne, puisqu’il comble à chaque bougie une partie de l’écart. Une position qui ne progresse plus finit donc par être stoppée. C’est voulu : Wilder considérait qu’une tendance qui ne se développe pas n’a pas de raison d’être conservée.
La fonction iSAR
int iSAR(
string symbol, // symbole, NULL = courant
ENUM_TIMEFRAMES period, // unité de temps, 0 = courante
double step, // pas du facteur d'accélération (0.02 typique)
double maximum // plafond du facteur (0.2 typique)
);
La fonction renvoie INVALID_HANDLE en cas d’échec. Le buffer unique se lit avec CopyBuffer(handle, 0, ...). Pour savoir de quel côté se trouve le SAR, il suffit de comparer sa valeur au prix de la même bougie : SAR sous le plus bas, tendance haussière ; SAR au-dessus du plus haut, tendance baissière.
Quelle bougie lire ?
La valeur de la bougie en cours (indice 0) est calculée à partir des bougies précédentes, mais elle peut changer si le prix franchit le SAR pendant la bougie et provoque un retournement. Pour un trailing stop, la lecture la plus sûre est celle de la dernière bougie clôturée (indice 1) : elle ne bougera plus. C’est un peu plus conservateur, car le stop suit avec une bougie de retard, mais vous évitez de placer un stop sur une valeur qui disparaît quelques secondes plus tard.
Exemple : un trailing stop Parabolic SAR avec CTrade
Le code suivant parcourt les positions du symbole portant le magic number de l’EA et rapproche leur stop loss du SAR, à trois conditions : le SAR est du bon côté du prix, le nouveau stop améliore l’ancien, et il respecte la distance minimale imposée par le courtier (SYMBOL_TRADE_STOPS_LEVEL).
#include <Trade\Trade.mqh>
input double InpStep = 0.02; // pas du SAR
input double InpMax = 0.2; // maximum du SAR
input long InpMagic = 20240312; // magic number des positions à gérer
CTrade trade;
int hSar = INVALID_HANDLE;
int OnInit()
{
hSar = iSAR(_Symbol, _Period, InpStep, InpMax);
if(hSar == INVALID_HANDLE) return(INIT_FAILED);
trade.SetExpertMagicNumber(InpMagic);
return(INIT_SUCCEEDED);
}
void OnDeinit(const int reason) { IndicatorRelease(hSar); }
void TrailWithSar()
{
double sar[];
ArraySetAsSeries(sar, true);
if(CopyBuffer(hSar, 0, 1, 1, sar) < 1) return; // SAR de la dernière bougie clôturée
double level = sar[0];
double bid = SymbolInfoDouble(_Symbol, SYMBOL_BID);
double ask = SymbolInfoDouble(_Symbol, SYMBOL_ASK);
double minGap = SymbolInfoInteger(_Symbol, SYMBOL_TRADE_STOPS_LEVEL) * _Point;
int digits = (int)SymbolInfoInteger(_Symbol, SYMBOL_DIGITS);
level = NormalizeDouble(level, digits);
for(int i = PositionsTotal() - 1; i >= 0; i--)
{
ulong ticket = PositionGetTicket(i);
if(ticket == 0) continue;
if(PositionGetString(POSITION_SYMBOL) != _Symbol) continue;
if(PositionGetInteger(POSITION_MAGIC) != InpMagic) continue;
double sl = PositionGetDouble(POSITION_SL);
double tp = PositionGetDouble(POSITION_TP);
long type = PositionGetInteger(POSITION_TYPE);
if(type == POSITION_TYPE_BUY)
{
// SAR sous le prix, meilleur que l'ancien stop, assez loin du Bid
if(level < bid - minGap && (sl == 0.0 || level > sl))
trade.PositionModify(ticket, level, tp);
}
else if(type == POSITION_TYPE_SELL)
{
// SAR au-dessus du prix, meilleur que l'ancien stop, assez loin de l'Ask
if(level > ask + minGap && (sl == 0.0 || level < sl))
trade.PositionModify(ticket, level, tp);
}
}
}
void OnTick()
{
static datetime lastBar = 0;
datetime t = iTime(_Symbol, _Period, 0);
if(t == lastBar) return; // un ajustement par bougie suffit
lastBar = t;
TrailWithSar();
}
Le parcours des positions part de la fin (PositionsTotal() - 1) par habitude : si une position se ferme pendant la boucle, les indices restants ne sont pas décalés. Le test level > sl pour un achat garantit que le stop ne recule jamais, propriété indispensable d’un trailing stop. Ce module n’ouvre aucune position : il se greffe sur votre logique d’entrée existante. Les principes généraux du stop suiveur sont détaillés dans Coder un trailing stop, et le parcours des positions dans Parcourir et filtrer les positions.
Pourquoi un seul ajustement par bougie
Le SAR de la bougie clôturée ne change qu’une fois par bougie. Le recalculer à chaque tick n’apporterait rien et multiplierait les requêtes de modification, que le serveur peut limiter (voir l’erreur 10024 Trop de requêtes). Si la modification échoue, par exemple parce que le prix s’est approché du stop entre-temps, la bougie suivante fera une nouvelle tentative avec une valeur plus récente.
Régler le pas et le maximum
Les deux paramètres agissent à des moments différents de la vie d’une position. Le pas détermine la vitesse initiale : avec 0,02, le SAR comble 2 % de l’écart au prix à la première bougie, puis 4 %, 6 % et ainsi de suite à chaque nouvel extrême. Le maximum plafonne cette progression : à 0,2, le SAR ne comble jamais plus de 20 % de l’écart par bougie. Un pas plus faible laisse respirer les positions au démarrage d’une tendance ; un maximum plus faible évite que le stop ne colle au prix après une longue série de nouveaux plus hauts.
Pour choisir, raisonnez en durée de détention. Mesurez dans le testeur le nombre moyen de bougies entre l’entrée et la sortie, et comparez-le à la durée des mouvements que votre logique d’entrée cherche à capter. Si le SAR coupe la plupart des positions bien avant ce terme, il est trop rapide pour votre stratégie, quel que soit le résultat global du backtest.
Usages en trading algorithmique
- Trailing stop. L’usage présenté ici, conforme à l’intention de Wilder et à l’aide de MT5, qui décrit le SAR comme un outil principalement destiné aux sorties.
- Sortie sur retournement. Plutôt que de modifier le stop, fermer la position dès qu’une bougie clôture de l’autre côté du SAR. La sortie est plus franche, mais intervient après la clôture et donc parfois plus loin.
- Filtre de direction. N’ouvrir des achats que si le SAR est sous le prix. Le SAR change souvent de côté en range, ce qui en fait un filtre peu sélectif.
- Stop initial. Placer le stop d’une nouvelle position sur le SAR courant, s’il est du bon côté, donne un stop cohérent avec le rythme récent du marché.
Limites et pièges
En marché sans tendance, le SAR change de côté très fréquemment : utilisé en système « toujours en position », il enchaîne les retournements perdants. Comme trailing stop, son accélération le rend parfois trop serré après une longue tendance : un repli ordinaire suffit à sortir. Augmenter le pas resserre encore le stop, le diminuer le relâche ; le maximum limite la vitesse de rapprochement en fin de tendance. Le SAR ne tient aucun compte de la volatilité absolue : sur un marché qui s’agite soudainement, il peut se retrouver à une distance inférieure au bruit normal des bougies. Comparer sa distance au prix avec un ATR permet de refuser les stops trop proches. Enfin, un stop modifié reste un ordre stop : en cas de gap, il est exécuté au premier prix disponible. Les autres indicateurs de tendance sont présentés dans la rubrique Indicateurs en MQL5.
FAQ
Combien de buffers a iSAR ?
Un seul, d’index 0, qui contient le niveau du SAR pour chaque bougie.
Comment savoir si le SAR indique une tendance haussière ?
Comparez sa valeur au prix de la même bougie : s’il est sous le plus bas, il accompagne une tendance haussière ; au-dessus du plus haut, une tendance baissière.
Pourquoi mon PositionModify échoue-t-il ?
Le plus souvent parce que le nouveau stop est trop proche du prix (distance inférieure à SYMBOL_TRADE_STOPS_LEVEL) ou du mauvais côté. Le code de l’exemple vérifie ces deux conditions avant d’envoyer la modification.
Quelles valeurs de pas et de maximum utiliser ?
La documentation cite 0,02 et 0,2 comme valeurs typiques. Un pas plus élevé resserre le stop plus vite ; testez plusieurs valeurs voisines et vérifiez la stabilité des résultats.
- Handles d’indicateurs et CopyBuffer
- iMA : moyennes mobiles
- iRSI : Relative Strength Index
- iMACD
- iBands : bandes de Bollinger
- iATR : Average True Range
- iStochastic
- iADX
- iCCI
- iMomentum
- iIchimoku
- iEnvelopes
- iWPR : Williams %R
- iAO : Awesome Oscillator
- iAC : Accelerator Oscillator
- iAlligator
- iFractals
- iOBV : On Balance Volume
- iMFI : Money Flow Index
- iVolumes
- iStdDev : écart-type
- iDeMarker
- iBearsPower et iBullsPower
- iForce
- iOsMA
- iRVI
- iAMA : moyenne mobile adaptative
- iDEMA et iTEMA
- iFrAMA
- iCustom : appeler un indicateur personnalisé
- Créer un indicateur personnalisé
- Buffers et styles de tracé
- OnCalculate et prev_calculated
- Indicateur multi-timeframe
- Objets graphiques (ObjectCreate)
