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

MQL5 · Indicateurs

iWPR en MQL5 : Williams %R, échelle négative et signal de sortie de zone

Lire le Williams %R avec iWPR, comprendre son échelle de -100 à 0 et son lien avec le stochastique, puis coder un signal armé à l’entrée en zone et déclenché à la sortie.

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

iWPR(symbole, unité de temps, période) crée un handle vers le Williams’ Percent Range (%R) de MetaTrader 5 ; l’indicateur a un seul buffer, d’index 0, dont les valeurs vont de -100 à 0. Cette échelle négative déroute souvent : -5 correspond à une clôture tout près du plus haut récent, -95 à une clôture tout près du plus bas. L’aide du terminal donne une consigne précieuse pour un robot : ne pas trader sur la seule lecture de surachat ou de survente, mais attendre que le prix change de direction. Cette page traduit cette consigne en code, avec une petite machine à états qui « arme » un signal à l’entrée en zone et le déclenche à la sortie.

Le calcul du Williams %R

L’aide de MetaTrader 5 donne la formule :

%R = -(plus haut des n bougies - clôture) / (plus haut des n bougies - plus bas des n bougies) × 100

Le %R mesure donc la distance entre la clôture et le plus haut du range récent, rapportée à la largeur de ce range. Une clôture au plus haut donne 0, une clôture au plus bas donne -100. L’aide précise que le signe moins n’est qu’une convention d’affichage, ignorée lors de l’analyse, et situe la zone de survente entre -80 et -100 et la zone de surachat entre 0 et -20.

Le lien avec le stochastique

Si vous comparez cette formule à celle du stochastique, vous constaterez que le %R est exactement le %K « rapide » (sans ralentissement, calculé sur plus bas et plus haut) décalé de 100 : %R = %K - 100. Les deux indicateurs portent donc la même information. La différence pratique tient à ce qui les entoure : le stochastique standard ajoute un lissage et une ligne de signal, alors que le %R est brut, donc plus nerveux. Si votre EA utilise déjà un stochastique avec un ralentissement de 1, ajouter un %R de même période n’apporte aucune information nouvelle ; vérifiez ce point avant de combiner des indicateurs, sous peine de compter deux fois la même condition.

La fonction iWPR

int iWPR(
   string          symbol,        // symbole, NULL = courant
   ENUM_TIMEFRAMES period,        // unité de temps, 0 = courante
   int             calc_period    // nombre de bougies du range
);

La fonction renvoie INVALID_HANDLE en cas d’échec. Il n’y a ni prix appliqué ni méthode de lissage : le calcul utilise toujours plus haut, plus bas et clôture. Le buffer 0 se lit avec CopyBuffer(), comme expliqué dans Handles d’indicateurs et CopyBuffer. L’exemple de la documentation fixe l’échelle de l’indicateur entre -100 et 0 et trace des niveaux à -20 et -80.

Attendre la sortie de zone : une machine à états

La consigne de l’aide se formule en deux temps. D’abord, le %R entre en zone de survente : c’est une condition, pas encore un signal. Ensuite, il en ressort : le prix s’est retourné, et c’est le déclencheur. Entre les deux, il peut s’écouler une bougie ou trente. Un robot doit donc garder une mémoire de l’état « armé ». Une variable statique suffit, complétée d’une durée maximale : si le %R reste trop longtemps en zone, le marché est probablement en tendance et le signal est abandonné.

Exemple : un EA à signal armé puis déclenché

input int    InpPeriod  = 14;     // période du %R
input double InpOversold   = -80.0;  // zone de survente
input double InpOverbought = -20.0;  // zone de surachat
input int    InpMaxBars = 10;     // durée maximale d'armement, en bougies

int hWpr = INVALID_HANDLE;

// État du signal : 0 = rien, +1 = achat armé, -1 = vente armée
int armedState = 0;
int armedBars  = 0;

int OnInit()
  {
   if(InpOversold >= InpOverbought) return(INIT_PARAMETERS_INCORRECT);
   hWpr = iWPR(_Symbol, _Period, InpPeriod);
   return(hWpr == INVALID_HANDLE ? INIT_FAILED : INIT_SUCCEEDED);
  }

void OnDeinit(const int reason) { IndicatorRelease(hWpr); }

void OnTick()
  {
   static datetime lastBar = 0;
   datetime t = iTime(_Symbol, _Period, 0);
   if(t == lastBar) return;

   double w[];
   ArraySetAsSeries(w, true);
   if(CopyBuffer(hWpr, 0, 0, 2, w) < 2) return;
   lastBar = t;
   double r = w[1];                         // %R de la dernière bougie clôturée

   // 1) Signal déjà armé : déclenchement, expiration ou maintien
   if(armedState != 0)
     {
      armedBars++;
      if(armedState > 0 && r > InpOversold)
        {
         PrintFormat("Achat déclenché : sortie de survente après %d bougies (%%R=%.1f)", armedBars, r);
         armedState = 0;
        }
      else if(armedState < 0 && r < InpOverbought)
        {
         PrintFormat("Vente déclenchée : sortie de surachat après %d bougies (%%R=%.1f)", armedBars, r);
         armedState = 0;
        }
      else if(armedBars >= InpMaxBars)
        {
         Print("Signal abandonné : zone extrême trop longue, probable tendance");
         armedState = 0;
        }
      return;
     }

   // 2) Aucun signal armé : entrée en zone extrême
   if(r <= InpOversold)   { armedState = +1; armedBars = 0; }
   if(r >= InpOverbought) { armedState = -1; armedBars = 0; }
  }

Les variables armedState et armedBars sont globales : elles survivent d’un tick à l’autre, mais pas à un redémarrage de l’EA ou du terminal. Pour un robot en production, cette perte de mémoire est acceptable ici (au pire, un signal est manqué) ; quand elle ne l’est pas, sauvegardez l’état comme expliqué dans Sauvegarder l’état dans des fichiers. Notez aussi que le déclenchement intervient à la clôture de la bougie qui sort de zone : l’entrée se fera à l’ouverture de la suivante.

Pourquoi une durée maximale

Sans InpMaxBars, un %R resté sous -80 pendant toute une baisse finirait par déclencher un achat au premier rebond, aussi faible soit-il, après des dizaines de bougies de chute. La durée maximale traduit une idée simple : une survente brève dans un marché équilibré est une opportunité de retour à la moyenne ; une survente prolongée est une tendance baissière, contre laquelle la stratégie ne veut pas se placer. La valeur de ce paramètre se choisit en mesurant la durée typique des passages en zone sur votre marché.

Choisir la période

La période du %R fixe la taille du range de référence. Avec 14 bougies, valeur courante, le range couvre un peu moins de trois semaines sur des données journalières et environ trois heures et demie en M15. Une période plus courte rend l’indicateur plus réactif, mais les passages en zone deviennent si fréquents que le filtre perd sa sélectivité. Une période plus longue rend les zones extrêmes plus rares et donc plus significatives, au prix de signaux moins nombreux. Pour trancher, comptez dans le testeur le nombre de signaux déclenchés par mois pour chaque période envisagée : en dessous de quelques signaux par mois, vos statistiques de backtest seront trop pauvres pour conclure ; au-delà de plusieurs par jour, les coûts de transaction pèseront lourd. Choisissez ensuite la durée maximale d’armement en cohérence avec cette période, par exemple une fraction de celle-ci.

Usages en trading algorithmique

  • Retour à la moyenne confirmé. L’exemple ci-dessus, adapté aux marchés sans tendance marquée. Combinez-le à un filtre de régime comme iADX pour ne l’activer qu’en range.
  • Repli dans une tendance. Avec un filtre de direction (moyenne longue), n’armer que les achats en tendance haussière : la sortie de survente marque alors la fin d’un repli.
  • Anticipation. L’aide de MT5 observe que le %R forme souvent son sommet et se retourne quelques bougies avant le prix. Cette propriété justifie son usage pour resserrer un stop plutôt que pour ouvrir une position inverse.
  • Mesure de position dans le range. Hors de toute zone, la valeur du %R indique simplement où se situe la clôture dans le range récent ; elle peut servir de variable dans un modèle plus large.

Limites et pièges

Le %R n’est pas lissé : sur une période courte, il passe d’un extrême à l’autre en quelques bougies, et une seule bougie à longue mèche peut le faire basculer. Comme tout oscillateur de range, il reste collé aux extrêmes en tendance ; la durée maximale de l’exemple atténue ce défaut sans l’éliminer. Les seuils -20 et -80 sont des conventions : le pourcentage de temps passé au-delà dépend fortement de la période et du marché. Gardez enfin en tête l’échelle négative : une condition écrite w[1] > 80 ne sera jamais vraie et ne provoquera aucune erreur de compilation. Ce type d’erreur silencieuse se repère en traçant les valeurs avec Print dans le testeur visuel. Les autres oscillateurs bornés sont présentés dans la rubrique Indicateurs en MQL5.

Une sortie de zone de survente n’assure pas un rebond durable ; le prix peut reprendre sa baisse immédiatement. Le code de cette page journalise des signaux sans passer d’ordres. Avant tout usage réel, ajoutez une gestion du risque complète, testez sur un long historique et sur compte de démonstration.

FAQ

Pourquoi le Williams %R est-il négatif ?

Par convention : la formule mesure la distance entre la clôture et le plus haut du range, affectée d’un signe moins. Les valeurs vont donc de -100 (clôture au plus bas) à 0 (clôture au plus haut). L’aide de MT5 précise que ce signe est ignoré dans l’analyse.

Combien de buffers a iWPR ?

Un seul, d’index 0.

Quelle différence entre Williams %R et stochastique ?

Le %R équivaut au %K rapide du stochastique décalé de 100. Le stochastique standard ajoute un lissage et une ligne de signal ; le %R est brut et plus nerveux.

Quels seuils utiliser ?

L’aide de MetaTrader 5 situe la survente entre -80 et -100 et le surachat entre 0 et -20. Ces valeurs sont un point de départ à vérifier sur votre marché.

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.