ProRealTime · Instructions
CCI en ProBuilder : Commodity Channel Index et seuils ±100
CCI[N] mesure l’écart du prix à sa moyenne en unités de déviation moyenne. Formule, choix de la série, lecture momentum ou retour à la moyenne et système ProBacktest.
CCI[N](price) renvoie le Commodity Channel Index : l’écart entre le prix et sa moyenne mobile sur N périodes, divisé par la déviation moyenne de ce prix. Contrairement au RSI ou au stochastique, le CCI n’est pas borné : il oscille autour de zéro et peut atteindre +300 ou −400 lors de mouvements exceptionnels. Les niveaux +100 et −100 servent de repères, mais leur franchissement ne veut pas dire la même chose selon que vous cherchez un excès à contrer ou un départ de tendance à suivre. Cette double lecture est le cœur de cette page.
Elle fait partie de la rubrique Les instructions ProBuilder essentielles. Si vous cherchez un oscillateur borné entre 0 et 100, reportez-vous plutôt à la page RSI.
Définition et calcul
La documentation ProBuilder donne la formule suivante :
CCI = (Prix − MM) / (0,015 × D)
- Prix : le prix typique, (plus haut + plus bas + clôture) / 3, dans la définition d’origine ;
- MM : la moyenne mobile simple de ce prix sur N périodes ;
- D : la déviation moyenne absolue du prix par rapport à sa moyenne sur N périodes.
La constante 0,015 a été choisie par l’auteur de l’indicateur, Donald Lambert, pour qu’une large majorité des valeurs se situe entre −100 et +100 sur les marchés qu’il étudiait. Ce n’est pas une garantie statistique : selon l’instrument et la période, la proportion de valeurs hors de ces bornes varie sensiblement.
Comme le CCI divise l’écart à la moyenne par une mesure de dispersion, il exprime cet écart en unités de volatilité. Une même distance en points produit un CCI élevé dans un marché calme et un CCI modéré dans un marché agité. C’est une parenté directe avec le z-score, qui utilise l’écart-type au lieu de la déviation moyenne (voir la page STD (écart-type)).
Syntaxe
CCI[N](price)
- N : nombre de périodes, souvent 14 ou 20 ;
- price : la série analysée. La documentation précise qu’on utilise typiquement le prix typique, mais que n’importe quelle série est possible ; son propre exemple utilise
close.
Pour coller à la définition d’origine, vous pouvez passer la constante TypicalPrice comme série : CCI[20](TypicalPrice). Les deux écritures produisent des courbes proches mais pas identiques ; choisissez-en une et tenez-vous-y dans tout votre code.
Exemple d’indicateur : CCI avec zones et durée hors bornes
// CCI sur prix typique, niveaux de référence et durée au-dessus de +100
n = 20
myCCI = CCI[n](TypicalPrice)
// Nombre de barres consécutives au-dessus de +100
IF myCCI > 100 THEN
barsHigh = barsHigh + 1
ELSE
barsHigh = 0
ENDIF
RETURN myCCI AS "CCI", 100 AS "+100", -100 AS "-100", 0 AS "zéro"
Vous pouvez afficher barsHigh dans un second indicateur pour observer combien de temps le CCI reste en zone haute. Sur un marché en tendance, ces séquences peuvent être longues : c’est l’argument principal de la lecture « momentum » du CCI.
La documentation officielle propose un exemple plus compact qui renvoie −1 sous −100 et +1 au-dessus de +100 :
myCCI = CCI[20](close)
SIGNAL = 0
IF myCCI < -100 THEN
SIGNAL = -1
ENDIF
IF myCCI > 100 THEN
SIGNAL = 1
ENDIF
RETURN SIGNAL
Exemple d’usage dans un système ProBacktest
Deux lectures du franchissement de +100 coexistent : un excès à vendre, ou un départ de tendance à acheter. Le système ci-dessous adopte la seconde, dite de momentum : il achète quand le CCI franchit +100 à la hausse et sort quand il repasse sous zéro.
// Système pédagogique : CCI en momentum
DEFPARAM CumulateOrders = false
DEFPARAM PRELOADBARS = 200
myCCI = CCI[20](TypicalPrice)
trend = Average[100](close)
IF NOT LongOnMarket AND close > trend AND myCCI CROSSES OVER 100 THEN
BUY 1 CONTRACTS AT MARKET
ENDIF
IF LongOnMarket AND myCCI CROSSES UNDER 0 THEN
SELL AT MARKET
ENDIF
IF NOT ShortOnMarket AND close < trend AND myCCI CROSSES UNDER -100 THEN
SELLSHORT 1 CONTRACTS AT MARKET
ENDIF
IF ShortOnMarket AND myCCI CROSSES OVER 0 THEN
EXITSHORT AT MARKET
ENDIF
SET STOP PLOSS 60
La lecture inverse, dite de retour à la moyenne, consiste à acheter quand le CCI repasse au-dessus de −100 après un passage en dessous, et à vendre à découvert quand il repasse sous +100 après un passage au-dessus. Notez la différence : on n’agit pas au moment où le CCI sort de la zone, mais quand il y revient, ce qui évite d’entrer contre un mouvement qui s’accélère. Les deux lectures sont légitimes ; ce qui ne l’est pas, c’est d’en changer selon le résultat du dernier backtest. La seconde est développée dans la page Retour à la moyenne.
Choisir sa lecture selon le marché
Le choix entre momentum et retour à la moyenne dépend du comportement de l’instrument et de l’unité de temps. Quelques repères pour orienter vos tests :
- un marché qui alterne longues phases de range et brèves impulsions favorise la lecture retour à la moyenne ;
- un marché qui tend à prolonger ses mouvements une fois lancés favorise la lecture momentum ;
- un filtre de régime, comme l’ADX, peut servir à choisir la lecture barre par barre.
Testez chaque lecture séparément, sur la même période et avec les mêmes coûts, avant de les combiner. Vous saurez ainsi laquelle porte réellement le résultat.
Le choix de la période
Avec une période courte (de 10 à 14), le CCI franchit fréquemment ses niveaux de référence et réagit aux mouvements de quelques barres ; avec une période longue (de 30 à 50), il décrit des écarts plus durables et produit beaucoup moins de signaux. Comme le CCI n’est pas borné, la période modifie aussi l’amplitude typique des valeurs : un seuil de +100 n’a pas la même rareté avec 10 qu’avec 50 périodes. Si vous changez la période, réexaminez sur le graphique la proportion de barres au-delà de vos seuils avant de les conserver.
Vérifier le CCI avant de l’utiliser
La formule étant publiée, vous pouvez la reconstruire pour vous assurer de ce que vous manipulez : calculez le prix typique, sa moyenne simple sur N barres, puis la déviation moyenne absolue avec une boucle FOR sur les N dernières barres. Comparez enfin votre résultat avec l’instruction native sur le même graphique. Si les deux courbes coïncident, vous savez exactement quelle série la plateforme utilise ; si un écart constant apparaît, c’est généralement la série d’entrée (clôture ou prix typique) qui diffère. Ce contrôle est aussi un excellent exercice pour comprendre pourquoi le CCI s’envole dans les marchés calmes : la déviation moyenne, au dénominateur, devient très petite.
Pièges fréquents
- Traiter ±100 comme des bornes. Le CCI les dépasse régulièrement ; un CCI à +250 n’est pas une anomalie de calcul.
- Comparer les valeurs de CCI calculées sur des séries différentes.
CCI[20](close)etCCI[20](TypicalPrice)ne donnent pas les mêmes valeurs ; ne mélangez pas les deux dans un même raisonnement. - Vendre un CCI élevé sans confirmation. Comme pour le RSI, un niveau extrême peut durer en tendance. Attendez au minimum le retour sous le seuil.
- Oublier la sensibilité aux marchés calmes. Dans une phase très calme, la déviation moyenne est faible et un petit mouvement produit un CCI élevé : filtrez éventuellement sur une volatilité minimale, par exemple avec l’ATR.
- Multiplier les seuils optimisés. ±100, ±150, ±200 : tester toutes les combinaisons de seuils d’entrée et de sortie mène vite à la sur-optimisation.
FAQ
Le CCI est-il borné entre −100 et +100 ?
Non. La constante 0,015 fait en sorte qu’une majorité des valeurs se situe dans cet intervalle, mais le CCI n’a pas de borne et peut dépasser largement ±200 lors de mouvements forts.
Faut-il calculer le CCI sur la clôture ou sur le prix typique ?
La définition d’origine utilise le prix typique, et la documentation indique que c’est l’usage habituel. L’exemple officiel utilise toutefois la clôture. Choisissez une série et gardez-la dans tout le système.
Quelle période utiliser ?
Les valeurs de 14 et 20 sont les plus répandues. Une période plus courte multiplie les franchissements de ±100, une période plus longue les raréfie. Adaptez les seuils si vous changez la période.
Le CCI convient-il aux actions comme aux matières premières ?
Il a été conçu pour les matières premières mais se calcule sur n’importe quelle série. Son comportement dépend de l’instrument : testez-le sur le marché visé plutôt que de reprendre des seuils génériques.
