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

MQL5 · Indicateurs

iEnvelopes en MQL5 : enveloppes en pourcentage et calibrage de l’écart

Lire les deux buffers d’iEnvelopes, comprendre la différence avec les bandes de Bollinger et calibrer l’écart des enveloppes avec un script qui mesure les sorties de bandes.

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

iEnvelopes() crée un handle vers l’indicateur Envelopes de MetaTrader 5 : deux lignes placées à un écart fixe en pourcentage au-dessus et en dessous d’une moyenne mobile. L’indicateur expose deux buffers, 0 pour la ligne haute (UPPER_LINE) et 1 pour la ligne basse (LOWER_LINE) ; la moyenne centrale n’est pas fournie. Tout l’enjeu des enveloppes tient dans un seul paramètre, l’écart (deviation) : trop faible, le prix sort sans cesse des bandes ; trop élevé, il n’en sort jamais. Cette page propose une méthode pour le calibrer à partir des données du symbole, plutôt que de le deviner ou de le livrer à l’optimiseur.

Le calcul des enveloppes

Le principe est simple : on calcule une moyenne mobile du prix, puis on trace une ligne au-dessus et une ligne en dessous, à une distance proportionnelle à cette moyenne. L’aide de MetaTrader 5 l’écrit avec une moyenne simple des clôtures :

  • bande haute = SMA(clôture, N) × (1 + K / 1000)
  • bande basse = SMA(clôture, N) × (1 - K / 1000)

La documentation de la fonction iEnvelopes() définit quant à elle le paramètre deviation comme l’écart à la ligne principale en pourcentage. Pour lever toute ambiguïté dans votre code, le plus sûr est de mesurer l’écart effectif à partir des deux buffers : (haute - basse) / (haute + basse) donne directement l’écart relatif de chaque bande par rapport à la moyenne, puisque la moyenne est le milieu des deux lignes. Le script de cette page affiche cette valeur pour chaque réglage testé.

La différence avec les bandes de Bollinger est fondamentale : la largeur des enveloppes ne dépend que du niveau de prix, pas de la volatilité. Quand le marché s’agite, les enveloppes ne s’élargissent pas ; le prix en sort donc plus souvent. Quand il se calme, il peut rester longtemps à l’intérieur sans jamais les toucher.

La fonction iEnvelopes

int iEnvelopes(
   string             symbol,          // symbole, NULL = courant
   ENUM_TIMEFRAMES    period,          // unité de temps, 0 = courante
   int                ma_period,       // période de la moyenne
   int                ma_shift,        // décalage horizontal
   ENUM_MA_METHOD     ma_method,       // méthode de lissage
   ENUM_APPLIED_PRICE applied_price,   // prix appliqué ou handle d'indicateur
   double             deviation        // écart des bandes, en pourcentage
);
BufferConstanteLigne
0UPPER_LINEenveloppe haute
1LOWER_LINEenveloppe basse

Attention à l’ordre des paramètres : contrairement à iBands(), l’écart vient en dernier, après le prix appliqué. La fonction renvoie INVALID_HANDLE en cas d’échec. Si vous avez besoin de la moyenne centrale, calculez la demi-somme des deux buffers ou créez un handle iMA avec les mêmes paramètres.

Calibrer l’écart sur les données

Une enveloppe est utile si elle découpe le marché en deux régimes : le prix est le plus souvent à l’intérieur, et en sort rarement. Plutôt que de choisir l’écart à l’œil, fixez la fréquence de sortie qui vous intéresse (par exemple 5 % des clôtures au-dessus de la bande haute) et cherchez l’écart qui la produit. Le script ci-dessous teste une liste d’écarts et affiche, pour chacun, l’écart effectif mesuré et le pourcentage de clôtures hors des enveloppes.

//+------------------------------------------------------------------+
//| Calibrage de l'écart des enveloppes                               |
//+------------------------------------------------------------------+
#property script_show_inputs

input int            InpPeriod  = 20;                     // période de la moyenne
input ENUM_MA_METHOD InpMethod  = MODE_SMA;               // méthode de lissage
input string         InpDevs    = "0.05,0.1,0.2,0.3,0.5"; // écarts testés
input int            InpBars    = 3000;                   // bougies analysées

void OnStart()
  {
   string parts[];
   int nDev = StringSplit(InpDevs, ',', parts);
   if(nDev <= 0) return;

   double closes[];
   ArraySetAsSeries(closes, true);
   int nClose = CopyClose(_Symbol, _Period, 1, InpBars, closes);   // bougies clôturées
   if(nClose <= 0) { Print("CopyClose a échoué"); return; }

   for(int d = 0; d < nDev; d++)
     {
      double dev = StringToDouble(parts[d]);
      int h = iEnvelopes(_Symbol, _Period, InpPeriod, 0, InpMethod, PRICE_CLOSE, dev);
      if(h == INVALID_HANDLE) continue;
      for(int k = 0; k < 50 && BarsCalculated(h) <= 0; k++) Sleep(100);

      double up[], lo[];
      ArraySetAsSeries(up, true);
      ArraySetAsSeries(lo, true);
      int n1 = CopyBuffer(h, UPPER_LINE, 1, nClose, up);
      int n2 = CopyBuffer(h, LOWER_LINE, 1, nClose, lo);
      int n  = MathMin(nClose, MathMin(n1, n2));
      if(n <= 0) { IndicatorRelease(h); continue; }

      int above = 0, below = 0;
      for(int i = 0; i < n; i++)
        {
         if(closes[i] > up[i]) above++;
         if(closes[i] < lo[i]) below++;
        }
      // Écart effectif de chaque bande par rapport à la moyenne, en %
      double effective = 100.0 * (up[0] - lo[0]) / (up[0] + lo[0]);

      PrintFormat("deviation=%.3f  écart effectif=%.3f %%  au-dessus=%.1f %%  en dessous=%.1f %%",
                  dev, effective, 100.0 * above / n, 100.0 * below / n);
      IndicatorRelease(h);
     }
  }

CopyClose() et CopyBuffer() démarrent tous deux à la position 1, avec des tableaux indexés en série : l’indice i désigne donc la même bougie dans les trois tableaux. C’est la condition pour que la comparaison ait un sens. Le principe de ces copies est rappelé dans Handles d’indicateurs et CopyBuffer.

Interpréter le résultat

Le tableau obtenu est propre au symbole et à l’unité de temps. Sur une paire de devises en H1, un écart de quelques dixièmes de pour cent peut suffire ; sur un indice ou une crypto-monnaie, il faut un écart bien plus large pour obtenir la même fréquence de sortie. Notez aussi l’asymétrie éventuelle : si le prix sort beaucoup plus souvent par le haut que par le bas, l’historique analysé est dominé par une tendance haussière, et une stratégie de retour à la moyenne y aurait été pénalisée à l’achat comme à la vente. Relancez le script sur plusieurs périodes : un écart dont la fréquence de sortie varie fortement d’une année à l’autre suit en réalité la volatilité, et serait mieux remplacé par des bandes de Bollinger ou un canal en ATR.

Du calibrage au signal

Une fois l’écart choisi, la traduction en règle d’EA est directe : lisez les buffers 0 et 1 aux indices 1 et 2, comparez-les aux clôtures correspondantes et détectez le passage de l’intérieur vers l’extérieur (ou l’inverse, selon votre logique). Un retour à l’intérieur après une sortie (closes[2] < lo[2] && closes[1] >= lo[1]) constitue une confirmation plus prudente qu’un simple contact. Séparez ce calcul de l’exécution, comme le recommande la page Coder un signal d’entrée : votre fonction de signal renvoie un sens, et le reste de l’EA décide du volume, du stop et du moment de l’envoi. Cette séparation permet aussi de réutiliser le même calibrage dans plusieurs EA sans dupliquer le code.

Usages en trading algorithmique

  • Retour à la moyenne. L’aide de MT5 présente le contact avec la bande haute comme un signal de vente et le contact avec la bande basse comme un signal d’achat, en raison du retour fréquent du prix vers des niveaux plus habituels après un excès. C’est le cadre des stratégies de retour à la moyenne, à réserver aux marchés sans tendance forte.
  • Cassure. Lecture inverse : une clôture nette hors de l’enveloppe, sur un marché habituellement contenu, peut signaler le début d’une tendance.
  • Filtre d’excès. Interdire les achats au-dessus de la bande haute, même si un autre signal les déclenche, évite d’entrer après un mouvement déjà étendu.
  • Objectif de sortie. La bande opposée ou la moyenne centrale sert de take profit dynamique.

Limites et pièges

L’écart fixe est à la fois la force et la faiblesse des enveloppes. Il les rend stables et lisibles, mais il les rend aveugles aux changements de volatilité : un écart calibré sur une période calme sera franchi en permanence lors d’une période agitée, et la stratégie de retour à la moyenne prendra position contre des mouvements de fond. Le calibrage proposé ici réduit ce risque sans le supprimer. Les enveloppes héritent aussi du retard de la moyenne mobile : en tendance, la moyenne suit le prix avec retard et la bande extérieure est franchie de façon répétée. Enfin, ne laissez pas l’optimiseur choisir à la fois la période, la méthode et l’écart : vous obtiendriez une combinaison ajustée à l’historique. Les autres indicateurs de canal et de volatilité figurent dans la rubrique Indicateurs en MQL5.

Un prix qui touche une enveloppe peut continuer dans la même direction bien au-delà. Les statistiques de sortie mesurées sur le passé ne garantissent rien pour l’avenir. Testez toute règle sur des données hors échantillon et sur compte de démonstration avant de l’utiliser en réel.

FAQ

Quels sont les buffers d’iEnvelopes ?

Le buffer 0 contient l’enveloppe haute (UPPER_LINE) et le buffer 1 l’enveloppe basse (LOWER_LINE). La moyenne centrale n’est pas exposée.

Comment obtenir la moyenne centrale ?

Calculez la demi-somme des deux buffers pour la même bougie, ou créez un handle iMA avec la même période, la même méthode et le même prix appliqué.

Dans quelle unité est exprimé le paramètre deviation ?

La documentation de la fonction l’exprime en pourcentage. Pour vérifier l’écart réellement appliqué, calculez (haute – basse) / (haute + basse) comme dans le script de calibrage.

Enveloppes ou bandes de Bollinger ?

Les enveloppes gardent un écart fixe en pourcentage, les bandes de Bollinger s’adaptent à la volatilité. Les premières conviennent aux marchés dont la volatilité varie peu, les secondes aux autres.

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.