MQL4 · Indicateurs
iCCI en MQL4 : le Commodity Channel Index dans un EA
iCCI renvoie la valeur du Commodity Channel Index, un oscillateur non borné. Signature, lecture des seuils ±100, retour depuis une zone extrême, iCCIOnArray et précautions propres à MQL4.
iCCI() renvoie en MQL4 la valeur du Commodity Channel Index de Donald Lambert pour la bougie désignée par shift. Contrairement au RSI ou au stochastique, le CCI n’est pas borné : il oscille autour de zéro et dépasse fréquemment +100 ou −100, parfois +300 lors de mouvements violents. La fonction n’a qu’une ligne et cinq paramètres. Cette page présente sa signature, la façon de traiter un oscillateur non borné dans un Expert Advisor, un exemple de retour depuis une zone extrême et la fonction iCCIOnArray() pour appliquer le CCI à vos propres séries.
La signature de iCCI
double iCCI(
string symbol, // symbole, NULL = symbole courant
int timeframe, // unité de temps, 0 = celle du graphique
int period, // période de calcul (14 par défaut sur le graphique)
int applied_price, // prix appliqué, PRICE_TYPICAL dans la définition d'origine
int shift // bougie lue : 0 = en cours, 1 = dernière clôturée
);
La définition d’origine du CCI utilise le prix typique, (haut + bas + clôture) / 3, ce qui correspond à PRICE_TYPICAL en MQL4. Le principe du calcul (écart entre le prix et sa moyenne, divisé par l’écart moyen absolu multiplié par la constante 0,015) est présenté sur la page iCCI en MQL5. La constante 0,015 a été choisie par Lambert pour qu’environ 70 à 80 % des valeurs tombent entre −100 et +100 ; ce n’est donc pas une limite, mais une échelle.
Un oscillateur non borné : ce que cela change dans le code
Avec un oscillateur borné, des niveaux comme 30 et 70 ont un sens universel. Avec le CCI, la question est différente : à quel point la valeur actuelle est-elle extrême par rapport à l’historique de ce marché ? Sur une paire de devises calme, le CCI 20 dépasse rarement ±200 ; sur une crypto-monnaie ou un indice volatil, il peut atteindre ±400. Trois conséquences pratiques :
- les seuils doivent être des paramètres, et ±100 n’est qu’un point de départ ;
- le franchissement de zéro est un signal de momentum utilisable sur tous les marchés, puisqu’il ne dépend pas de l’échelle ;
- un test du type
cci > 100ne signale pas forcément un excès : dans la logique de Lambert, un passage au-dessus de +100 marque le début d’une tendance haussière forte, pas un surachat à vendre.
Deux lectures opposées du même seuil
Les traders utilisent le CCI de deux façons contradictoires, et il est important de savoir laquelle vous codez.
En suivi de tendance, le franchissement de +100 vers le haut est un signal d’achat : le prix s’écarte nettement de sa moyenne, ce qui traduit une impulsion. La position est fermée quand le CCI repasse sous +100 ou sous zéro.
En retour à la moyenne, une valeur sous −100 est considérée comme un excès baissier, et l’achat intervient lorsque le CCI repasse au-dessus de −100, signe que l’excès se résorbe.
Les deux approches peuvent fonctionner selon le marché et l’unité de temps, mais elles prennent des positions opposées au même moment. Un EA doit en choisir une et l’assumer, de préférence avec un filtre de contexte.
Exemple complet : retour depuis la zone −100 / +100
L’EA ci-dessous applique la logique de retour : il achète quand le CCI repasse au-dessus du seuil bas, vend quand il repasse sous le seuil haut, et ferme la position existante sur signal inverse.
#property strict
input int PeriodeCCI = 20;
input double SeuilHaut = 100.0;
input double SeuilBas = -100.0;
input int StopPoints = 350;
input double Lots = 0.10;
input int Magic = 41008;
datetime derniereBougie = 0;
void OnTick()
{
if(Time[0] == derniereBougie) return;
derniereBougie = Time[0];
double cci1 = iCCI(NULL, 0, PeriodeCCI, PRICE_TYPICAL, 1);
double cci2 = iCCI(NULL, 0, PeriodeCCI, PRICE_TYPICAL, 2);
int signal = -1; // -1 = aucun signal
if(cci2 < SeuilBas && cci1 >= SeuilBas) signal = OP_BUY;
if(cci2 > SeuilHaut && cci1 <= SeuilHaut) signal = OP_SELL;
if(signal < 0) return;
if(!FermerOpposees(signal)) return; // on attend la prochaine bougie
if(PositionDansLeSens(signal)) return;
RefreshRates();
double prix = (signal == OP_BUY) ? Ask : Bid;
double sl = (signal == OP_BUY) ? prix - StopPoints * Point : prix + StopPoints * Point;
if(OrderSend(Symbol(), signal, Lots, prix, 3, NormalizeDouble(sl, Digits), 0,
"CCI", Magic, 0, clrNONE) < 0)
Print("OrderSend : erreur ", GetLastError());
}
bool FermerOpposees(int sens)
{
bool ok = true;
for(int i = OrdersTotal() - 1; i >= 0; i--)
{
if(!OrderSelect(i, SELECT_BY_POS, MODE_TRADES)) continue;
if(OrderSymbol() != Symbol() || OrderMagicNumber() != Magic) continue;
if(OrderType() == sens || OrderType() > OP_SELL) continue;
double prix = (OrderType() == OP_BUY) ? Bid : Ask;
if(!OrderClose(OrderTicket(), OrderLots(), prix, 3, clrGray))
{ Print("OrderClose : erreur ", GetLastError()); ok = false; }
}
return(ok);
}
bool PositionDansLeSens(int sens)
{
for(int i = OrdersTotal() - 1; i >= 0; i--)
if(OrderSelect(i, SELECT_BY_POS, MODE_TRADES) && OrderSymbol() == Symbol()
&& OrderMagicNumber() == Magic && OrderType() == sens) return(true);
return(false);
}
La boucle de fermeture parcourt les ordres à rebours, de OrdersTotal() - 1 vers 0 : fermer un ordre décale les index des suivants, et une boucle croissante en sauterait. Ce point est détaillé dans OrderSelect et boucles, et la fermeture elle-même dans OrderClose.
Le croisement de zéro, signal universel
Parce qu’il ne dépend pas de l’échelle du marché, le passage du CCI par zéro est la lecture la plus facile à transposer d’un symbole à l’autre. Un CCI qui passe de négatif à positif indique que le prix typique est repassé au-dessus de sa moyenne : c’est un signal de momentum, proche dans l’esprit d’un croisement prix / moyenne mobile, mais normalisé par la dispersion récente. Dans un robot, il sert souvent de sortie plutôt que d’entrée : une position achetée sur retour depuis −100 peut être fermée lorsque le CCI repasse sous zéro après être monté, ce qui évite de rendre tout le gain. Comme pour les seuils, ce croisement se lit entre deux bougies clôturées.
Choisir la période
La période 14 est celle proposée par défaut par l’indicateur du terminal, mais Lambert travaillait à l’origine sur des cycles et recommandait une période inférieure au tiers du cycle étudié. En pratique, une période courte (10 à 14) rend le CCI très nerveux et multiplie les passages au-delà de ±100 ; une période plus longue (20 à 50) les raréfie. Un CCI 20, comme dans l’exemple, est un compromis courant. Testez la stabilité des résultats sur plusieurs périodes voisines avant d’en retenir une.
iCCIOnArray : le CCI de vos propres données
MQL4 fournit iCCIOnArray(double array[], int total, int period, int shift) pour calculer un CCI sur un tableau que vous remplissez vous-même, par exemple le ratio entre deux symboles corrélés. Le tableau doit être déclaré en série avec ArraySetAsSeries() pour que l’indice 0 désigne la valeur la plus récente, comme pour les autres fonctions OnArray de la rubrique Indicateurs en MQL4. Remplissez au moins period valeurs de plus que le shift lu, sinon le calcul porte sur des éléments vides.
Pièges fréquents
- Seuils copiés d’un autre marché : un réglage ±100 adapté à EURUSD H1 peut générer un signal par jour sur un indice M5. Étudiez la distribution du CCI sur votre marché avant de fixer les seuils.
- Prix appliqué différent du graphique : l’indicateur CCI du terminal propose un réglage de prix. Si l’EA utilise
PRICE_TYPICALet le graphiquePRICE_CLOSE, les valeurs ne correspondront pas. - Bougie 0 : comme tout oscillateur, le CCI de la bougie en cours change à chaque tick. Les franchissements doivent être lus sur des bougies clôturées.
- Lecture en tendance : en logique de retour, une forte tendance produit des signaux contraires répétés. Un filtre de tendance de fond limite cette exposition.
FAQ
Le CCI a-t-il une valeur maximale ?
Non. Le CCI n’est pas borné : il dépasse régulièrement ±100 et peut atteindre ±300 ou plus lors de mouvements violents. Les seuils sont donc à adapter à chaque marché.
Quel prix appliqué utiliser avec iCCI ?
La définition d’origine utilise le prix typique, soit PRICE_TYPICAL. Vous pouvez choisir la clôture, mais pensez à appliquer le même réglage à l’indicateur affiché sur le graphique pour vos vérifications.
Faut-il acheter ou vendre au-dessus de +100 ?
Cela dépend de la logique choisie. En suivi de tendance, le franchissement de +100 est un signal d’achat ; en retour à la moyenne, c’est le retour sous +100 qui déclenche une vente. Les deux lectures s’opposent : choisissez-en une et testez-la.
Le CCI convient-il aux marchés sans tendance ?
Sa lecture en retour à la moyenne est conçue pour ce type de marché, mais elle souffre dès qu’une tendance s’installe. Combinez-la avec un filtre de régime, par exemple un ADX faible, pour limiter les signaux à contre-tendance.
Pourquoi parcourir les ordres à rebours dans la boucle de fermeture ?
Fermer un ordre le retire de la liste et décale les index des ordres suivants. Une boucle décroissante garantit qu’aucun ordre n’est sauté.
