How it works
The Choppiness Index measures efficiency of movement. It compares how much distance the market covered bar by bar with how far it actually got from one end of the window to the other. A market that trends spends most of its bar-by-bar movement making net progress, so the two quantities are similar. A market that chops covers enormous total ground while ending up where it started, so the ratio blows out. Expressed on a logarithmic scale bounded roughly between 0 and 100, that ratio becomes a clean regime classifier.
This is not a volatility measure in the usual sense and it is a mistake to read it as one. A quiet range and a violent range can both score as choppy, and a slow grind and a crash can both score as trending. What the index isolates is the geometry of the move rather than its size, which makes it complementary to ATR rather than a substitute for it. The pairing is natural: ATR says how much is happening, the choppiness index says whether any of it is going anywhere.
Its main job is as a filter that decides which of your other tools should be listened to. Above roughly 61.8 the market is consolidating, which is when reversion rules, range fades and premium selling do well and trend-following rules get shredded. Below roughly 38.2 the market is travelling, which is when breakout and trend rules earn their keep and reversion rules get run over. Those two thresholds are Fibonacci-derived, which has no theoretical justification, but they land close enough to sensible empirical boundaries that they have stuck.
The most valuable and least intuitive reading is the extreme low. Because the index measures efficiency and not direction, a very low reading means the market has just travelled a long way in a straight line, which is a late-stage trend condition rather than a fresh signal. Practitioners therefore often read the extremes inversely from what the labels suggest: a very high reading warns that the coiling is nearly done and a very low reading warns that the run is mature.
Calculation
The arithmetic in words, in the order it happens.
Over a lookback of N bars, conventionally 14, sum the true range of each bar, where true range is the largest of the high minus the low, the absolute difference between the high and the previous close, and the absolute difference between the low and the previous close. Divide that sum by the total range of the window, namely the highest high over N minus the lowest low over N. Take the base-10 logarithm of that ratio, divide by the base-10 logarithm of N, and multiply by 100. The result is bounded near 0 and 100: a perfectly directional market in which each bar continues the last gives a ratio near 1 and a reading near 0, while a market whose bars retrace each other repeatedly gives a large ratio and a reading near 100.
Source
An AlgoBeamScript implementation of the formula above, written by us from the arithmetic so the code and the calculation agree line for line.
Runs unchanged on the platform and in the AlgoBeamTS runtime. The language reference is in the documentation.
Inputs
Defaults are the values most charting packages ship with. They are conventions, not optimal settings — the right length depends on your instrument and your holding period.
| Input | Default | What it changes |
|---|---|---|
| Length | 14 | Bars in both the true-range sum and the high-low range. Shorter windows classify regimes quickly and flip often; 28 or more gives a stable regime read suitable for gating a whole strategy on and off. |
| Upper threshold | 61.8 | Level above which the market is treated as consolidating. Raising it makes the choppy classification rarer and therefore more reliable, at the cost of leaving trend rules enabled in poor conditions. |
| Lower threshold | 38.2 | Level below which the market is treated as trending. Lowering it demands a stronger, straighter move before trend rules are enabled, which reduces false starts but also delays entries. |
How to read it
What practitioners take from the plot. Read these as descriptions of market state, not as entry signals.
- Above 61.8
- A consolidation regime. Range and reversion rules are in their element; trend-following crossovers will whipsaw.
- Below 38.2
- A directional regime. Price is travelling efficiently, which favours breakout and trend continuation rules.
- Falling sharply from above 61.8
- A coiled market has begun to travel. This transition, not the absolute level, is where the index is most useful.
- At a multi-month low
- An unusually efficient run. Trends this clean are usually mature, so read it as a warning about a late stage rather than as a fresh entry.
Limitations
Where this indicator misleads. None of these are fixed by a better parameter.
- It is completely directionless. A reading of 20 tells you the market is trending, not whether it is trending up or down, so it can never be used alone.
- It lags by the length of its own window. By the time the reading confirms a trending regime a substantial part of the move has already occurred, which is the standard cost of any regime filter.
- The 61.8 and 38.2 thresholds are conventional rather than derived, and they behave differently across asset classes. Foreign exchange and index futures sit in different typical ranges, so thresholds should be calibrated per instrument.
- Extreme readings are frequently misread. A very low value looks like a green light for trend entries when it more often marks the late stage of a move that is about to consolidate.
Educational reference. This page explains how an indicator is built and how it is commonly read. It is not investment advice, not a recommendation and not a signal service. No indicator is profitable on its own — each is a way of describing a market, and any rule built on one has to be tested with realistic costs before it is traded.