MQL5 · Indicateurs
iCCI en MQL5 : lire le Commodity Channel Index en mode tendance
Lire le CCI avec iCCI, comprendre pourquoi cet oscillateur n’a pas de bornes et l’exploiter en mode tendance dans un Expert Advisor qui franchit les niveaux ±100.
iCCI(symbole, unité de temps, période, prix appliqué) crée un handle vers le Commodity Channel Index ; l’indicateur n’a qu’un buffer, d’index 0. À la différence du RSI ou du stochastique, le CCI n’est pas borné : il oscille le plus souvent entre -100 et +100, mais peut atteindre +250 ou -300 lors d’un mouvement violent. Cette particularité change la façon de l’utiliser dans un robot. Plutôt que de le lire comme un oscillateur de surachat, cette page montre son usage en mode tendance : entrer quand le CCI franchit +100 ou -100, c’est-à-dire quand le prix s’écarte nettement de sa moyenne, et sortir quand il revient vers zéro.
Le calcul du CCI
Le CCI, proposé par Donald Lambert, mesure l’écart entre le prix et sa moyenne, rapporté à la dispersion habituelle de ce prix. Sa construction, sur N périodes :
- Prix typique :
TP = (plus haut + plus bas + clôture) / 3. - Moyenne :
SMA(TP, N). - Écart moyen : moyenne, sur N bougies, des écarts absolus entre TP et sa moyenne.
- CCI :
(TP - SMA(TP, N)) / (0,015 × écart moyen).
La constante 0,015 a été choisie pour qu’environ 70 à 80 % des valeurs tombent entre -100 et +100 sur les données de l’époque. L’aide de MetaTrader 5 décrit les mêmes étapes, avec la même constante, mais son écriture de la dernière étape inverse le numérateur et le dénominateur : retenez la forme ci-dessus, qui est la définition d’origine et celle qui produit les valeurs affichées par le terminal.
Concrètement, un CCI de +100 signifie que le prix typique se trouve à 1,5 écart moyen au-dessus de sa moyenne (100 × 0,015 = 1,5). Un CCI de +200 correspond à 3 écarts moyens. Cette lecture en « écarts moyens » est plus utile que l’image du surachat : elle vous dit à quel point le mouvement actuel sort de l’ordinaire.
La fonction iCCI
int iCCI(
string symbol, // symbole, NULL = courant
ENUM_TIMEFRAMES period, // unité de temps, 0 = courante
int ma_period, // période de calcul
ENUM_APPLIED_PRICE applied_price // prix appliqué ou handle d'indicateur
);
Un seul buffer, d’index 0 ; INVALID_HANDLE en cas d’échec. Pour retrouver le CCI standard, passez PRICE_TYPICAL comme prix appliqué. Avec PRICE_CLOSE, le calcul porte sur la clôture seule et les valeurs changent : vérifiez que votre EA et le graphique utilisent le même réglage. Le principe de lecture du buffer est décrit dans Handles d’indicateurs et CopyBuffer.
Pourquoi l’absence de bornes change tout
Avec un oscillateur borné, « au-dessus de 80 » décrit toujours une situation rare. Avec le CCI, un seuil fixe n’a pas la même signification selon la période de calcul et le marché : sur une période courte, les dépassements de ±100 sont fréquents ; sur une période longue, ils deviennent plus rares. Trois conséquences pour le code :
- les seuils ±100 sont un point de départ, pas une constante universelle ; mesurez leur fréquence de franchissement sur vos données ;
- une valeur extrême (CCI à +300) n’annonce pas un retournement imminent : elle décrit un mouvement exceptionnellement fort, qui peut continuer ;
- la ligne zéro est un repère fiable : elle indique que le prix typique est revenu sur sa moyenne.
Exemple : un EA de CCI en mode tendance
L’EA suivant achète quand le CCI franchit +100 à la hausse et vend à découvert quand il franchit -100 à la baisse, sur bougie clôturée. La position est fermée quand le CCI repasse la ligne zéro dans l’autre sens. Un stop fixe en points protège chaque position.
#include <Trade\Trade.mqh>
input int InpPeriod = 20; // période du CCI
input double InpLevel = 100.0; // seuil d'entrée
input double InpLots = 0.10; // volume
input int InpStopPts = 500; // stop loss en points
input long InpMagic = 20240209; // magic number
CTrade trade;
int hCci = INVALID_HANDLE;
int OnInit()
{
hCci = iCCI(_Symbol, _Period, InpPeriod, PRICE_TYPICAL);
if(hCci == INVALID_HANDLE) return(INIT_FAILED);
trade.SetExpertMagicNumber(InpMagic);
return(INIT_SUCCEEDED);
}
void OnDeinit(const int reason) { IndicatorRelease(hCci); }
void OnTick()
{
static datetime lastBar = 0;
datetime t = iTime(_Symbol, _Period, 0);
if(t == lastBar) return;
double cci[];
ArraySetAsSeries(cci, true);
if(CopyBuffer(hCci, 0, 0, 3, cci) < 3) return;
lastBar = t;
bool hasPos = PositionSelect(_Symbol) && PositionGetInteger(POSITION_MAGIC) == InpMagic;
// 1) Sortie : retour à travers la ligne zéro
if(hasPos)
{
long type = PositionGetInteger(POSITION_TYPE);
if(type == POSITION_TYPE_BUY && cci[2] >= 0 && cci[1] < 0) trade.PositionClose(_Symbol);
if(type == POSITION_TYPE_SELL && cci[2] <= 0 && cci[1] > 0) trade.PositionClose(_Symbol);
return; // une seule position à la fois
}
// 2) Entrée : franchissement des seuils
double stop = InpStopPts * _Point;
if(cci[2] <= InpLevel && cci[1] > InpLevel)
{
double ask = SymbolInfoDouble(_Symbol, SYMBOL_ASK);
trade.Buy(InpLots, _Symbol, ask, ask - stop, 0.0, "CCI > +seuil");
}
else if(cci[2] >= -InpLevel && cci[1] < -InpLevel)
{
double bid = SymbolInfoDouble(_Symbol, SYMBOL_BID);
trade.Sell(InpLots, _Symbol, bid, bid + stop, 0.0, "CCI < -seuil");
}
}
Cet exemple utilise PositionSelect(_Symbol), adapté à un compte netting ; en hedging, parcourez les positions et filtrez par magic number (voir Parcourir et filtrer les positions). Le stop fixe en points est un choix de simplicité : un stop proportionnel à l’ATR serait plus cohérent avec la logique du CCI, qui mesure lui-même l’écart en unités de dispersion.
Calibrer le seuil et la période
Puisque le CCI n’a pas de bornes, le couple période-seuil détermine directement la fréquence des signaux. Avant d’optimiser quoi que ce soit, mesurez cette fréquence : comptez, sur quelques milliers de bougies, combien de fois le CCI franchit +100 à la hausse. Sur une période de 14, ces franchissements sont nombreux et beaucoup ne durent qu’une ou deux bougies ; sur une période de 50, ils sont plus rares et correspondent à des écarts plus durables. Un seuil de 150 ou 200 réduit encore le nombre d’entrées et ne retient que les mouvements réellement inhabituels.
Gardez à l’esprit que chaque transaction paie le spread et, le cas échéant, une commission. Un réglage qui multiplie les entrées sur des écarts faibles peut sembler intéressant avant coûts et devenir perdant une fois ceux-ci intégrés. Dans le testeur, utilisez un spread réaliste et comparez le gain moyen par transaction au coût moyen d’une transaction : si le premier n’est pas nettement supérieur au second, augmentez la période ou le seuil plutôt que d’ajouter des filtres.
Une erreur fréquente : le seuil testé sur la bougie en cours
Tester cci[0] > 100 déclenche l’entrée dès que le seuil est franchi en cours de bougie, puis la bougie peut clôturer sous le seuil. En backtest « prix d’ouverture uniquement », ce cas n’existe pas ; en réel, il génère des entrées que le test n’a jamais vues. Lisez toujours les indices 1 et 2, comme dans l’exemple.
Usages en trading algorithmique
- Mode tendance. L’exemple ci-dessus : le franchissement de ±100 signale un écart inhabituel à la moyenne, que l’on suit jusqu’au retour vers zéro. C’est la lecture proche de l’intention d’origine de Lambert, qui cherchait à repérer le début de cycles.
- Retour à la moyenne. Lecture inverse, citée par l’aide de MT5 : au-delà de +100, une correction est possible. Elle demande une confirmation (retour sous +100) et fonctionne plutôt en range.
- Divergences. L’aide décrit la divergence classique : nouveau plus haut du prix sans nouveau plus haut du CCI. Comme pour les autres oscillateurs, son codage exige une définition précise des sommets.
- Filtre de position par rapport à la moyenne. Le simple signe du CCI indique si le prix typique est au-dessus ou en dessous de sa moyenne, en tenant compte de la volatilité.
Limites et pièges
Le CCI repose sur une moyenne simple et un écart moyen calculés sur la même fenêtre : une bougie extrême gonfle l’écart moyen pendant N bougies, ce qui écrase les valeurs suivantes, puis le fait retomber brutalement quand elle sort de la fenêtre. En mode tendance, les franchissements de ±100 en marché agité produisent des entrées rapidement contredites ; un filtre de régime ou une période plus longue limite ce défaut. Les deux usages (tendance et retour à la moyenne) sont contradictoires : choisissez-en un et testez-le seul, plutôt que de laisser l’optimiseur trouver un mélange qui ne tient que sur l’historique. Les autres oscillateurs de la rubrique Indicateurs en MQL5, comme iMomentum, offrent des mesures plus simples de la même idée.
FAQ
Le CCI est-il borné entre -100 et +100 ?
Non. La plupart des valeurs se situent dans cet intervalle, mais le CCI peut le dépasser largement lors de mouvements forts. Les niveaux ±100 sont des repères, pas des limites.
Quel prix appliqué choisir pour iCCI ?
PRICE_TYPICAL, soit (plus haut + plus bas + clôture) / 3, correspond à la définition d’origine. Les autres prix sont possibles mais donnent des valeurs différentes.
Combien de buffers a iCCI ?
Un seul, d’index 0.
Que signifie un CCI de +200 ?
Que le prix typique se trouve à environ trois écarts moyens au-dessus de sa moyenne mobile. C’est un mouvement inhabituel, pas nécessairement un signal de retournement.
- Handles d’indicateurs et CopyBuffer
- iMA : moyennes mobiles
- iRSI : Relative Strength Index
- iMACD
- iBands : bandes de Bollinger
- iATR : Average True Range
- iStochastic
- iADX
- iMomentum
- iIchimoku
- iSAR : Parabolic SAR
- 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)
