Commodity Channel Index (CCI)

1. Summary (Introduction)

The Commodity Channel Index (CCI) is a versatile momentum oscillator developed by Donald Lambert, first introduced in "Commodities" magazine in 1980. Despite its name, it is used effectively in any market, including stocks, forex, and futures.

The CCI measures the current price level relative to an average price level over a specified period. It is designed to identify cyclical turns in commodities but is widely used to detect overbought and oversold conditions. High values indicate that the price is unusually high compared to its average, and low values indicate it is unusually low.

2. Mathematical Foundations and Calculation Logic

The CCI is based on the relationship between the price, its moving average, and the average deviation from that moving average.

Required Components

Period (N): The lookback period for all calculations (e.g., 20).
Source Price (P): The price series used for the calculation. The classic definition uses the Typical Price (High + Low + Close) / 3.
Constant: A statistical constant of 0.015 used to scale the result so that approximately 70% to 80% of values fall between the -100 and +100 levels.

Calculation Steps (Algorithm)

Calculate the Source Price: For each bar, calculate the source price (e.g., Typical Price). \text{P}_i = \frac{\text{High}_i + \text{Low}_i + \text{Close}_i}{3}
Calculate the Simple Moving Average (SMA): Compute an N-period SMA of the source price. \text{SMA}_i = \text{SMA}(P, N)_i
Calculate the Mean Absolute Deviation (MAD): For each bar, calculate the average absolute difference between the source price and its SMA over the N period. \text{MAD}_i = \frac{1}{N} \sum_{k=i-N+1}^{i} \text{Abs}(P_k - \text{SMA}_i)
Calculate the CCI Value: Apply the final formula. \text{CCI}_i = \frac{P_i - \text{SMA}_i}{0.015 \times \text{MAD}_i}

3. MQL5 Implementation Details

Our MQL5 toolkit includes two distinct standard implementations of the CCI, along with their Heikin Ashi counterparts, to offer a choice between performance and perfect mathematical accuracy.

Stability via Full Recalculation: All versions employ a "brute-force" full recalculation within the OnCalculate function to ensure maximum stability.
Self-Contained Logic: All versions are completely self-contained, with fully manual calculations for all components, making them independent of external handles or libraries.
Optional Signal Line: All versions have been enhanced with an optional, user-configurable moving average signal line, complete with our robust, manual calculation logic for all MA types.

Our Two Standard Versions

Efficient Version (CCI.mq5):
- Concept: A high-performance implementation suitable for most applications, including Expert Advisors.
- Logic: This version uses an efficient sliding window sum technique to calculate both the SMA and the Mean Absolute Deviation (MAD). This is a very close approximation of the precise formula but avoids nested loops, making it significantly faster.
Precise Version (CCI_Precise.mq5):
- Concept: A version that adheres strictly to the mathematical definition for maximum accuracy.
- Logic: This implementation uses nested for loops. For every single bar, it recalculates the precise SMA and then the precise MAD based on that SMA. While slightly slower, it guarantees a result that is 100% faithful to the textbook formula.

Heikin Ashi Variants:
- Both the efficient (CCI_HeikinAshi.mq5) and precise (CCI_Precise_HeikinAshi.mq5) versions have a "pure" Heikin Ashi counterpart. The calculation logic in each is identical to its standard parent, but they use the smoothed Heikin Ashi price data as their input. This results in a smoother oscillator that reflects the momentum of the underlying Heikin Ashi trend.

4. Parameters

CCI Period (InpCCIPeriod): The lookback period for the SMA and MAD calculations. Common values are 14 or 20.
Applied Price (InpAppliedPrice): The source price for the calculation. The classic and default is PRICE_TYPICAL.
Signal Line Settings:
- InpMAPeriod: The lookback period for the optional signal line.
- InpMAMethod: The type of moving average for the signal line.

5. Usage and Interpretation

Overbought/Oversold Levels: The primary use of the CCI is to identify extreme conditions.
- Overbought: Readings above +100 are considered overbought, suggesting the price has moved too far, too fast and may be due for a correction.
- Oversold: Readings below -100 are considered oversold, suggesting a potential bounce.
Zero Line Crossovers: A crossover of the CCI line above the zero line is a bullish signal, indicating that momentum has shifted to the upside. A crossover below zero is a bearish signal.
Divergence: This is a powerful signal. A bearish divergence (higher price highs, lower CCI highs) can signal a potential top. A bullish divergence (lower price lows, higher CCI lows) can signal a potential bottom.
Trend Confirmation: In an uptrend, the CCI tends to stay above the zero line. In a downtrend, it tends to stay below it.
Caution: CCI is an unbound oscillator, meaning it has no theoretical upper or lower limit. This makes divergence signals particularly potent. It can produce many signals in choppy markets.

5.4 KiB Raw Blame History