QuanTAlib/lib/volume/adosc/Adosc.md

ADOSC: Chaikin A/D Oscillator

"Momentum precedes price. Volume momentum precedes price momentum."

The Chaikin Oscillator (ADOSC) is an indicator of an indicator. It applies the MACD formula to the Accumulation/Distribution Line (ADL) instead of the price.

While the ADL is great for spotting long-term flow, it can be sluggish. ADOSC acts as a turbocharger, measuring the momentum of that flow. It anticipates changes in the ADL, often signaling a reversal before the ADL itself turns.

Historical Context

Marc Chaikin created this oscillator because he found the standard ADL too slow for timing entries. He realized that applying the moving average convergence/divergence (MACD) logic to the ADL would highlight the acceleration and deceleration of buying pressure.

Architecture & Physics

ADOSC is a derivative indicator. It depends on:

1. ADL: The base volume flow metric.
2. EMA: Two exponential moving averages of that metric.

The physics here is identical to MACD:

• Fast EMA (3): Represents the immediate, short-term money flow.
• Slow EMA (10): Represents the established, medium-term money flow.
• Difference: The spread between them represents the momentum of accumulation.

Mathematical Foundation

ADOSC_t = EMA(ADL, 3)_t - EMA(ADL, 10)_t

Where:

• ADL is the Accumulation/Distribution Line.
• EMA(X, N) is the Exponential Moving Average of X over N periods.

Performance Profile

ADOSC is slightly heavier than ADL because it involves two EMAs.

Metric	Score	Notes
Throughput	15ns	1 ADL update + 2 EMA updates
Allocations	0	Hot path is allocation-free
Complexity	O(1)	Constant time per update
Accuracy	10/10	Matches all major libraries
Timeliness	10/10	Leading indicator of momentum
Overshoot	8/10	Can be volatile in choppy markets
Smoothness	8/10	Smoothed by EMAs

Validation

Validation is performed against TA-Lib, Skender, Tulip, and OoplesFinance.

Library	Status	Notes
QuanTAlib	✅	Validated.
TA-Lib	✅	Matches AdOsc exactly.
Skender	✅	Matches ChaikinOsc.
Tulip	✅	Matches adosc.
Ooples	✅	Matches ChaikinOscillator.

Common Pitfalls

• Volatility: ADOSC is extremely volatile. It whipsaws frequently. It should never be used in isolation.
• Trend Confirmation: Use it to confirm a trend, not to predict it. If price is rising but ADOSC is falling (divergence), the rally is running on fumes.
• Zero Line: Crosses above zero indicate that short-term accumulation is overpowering long-term accumulation (Bullish). Crosses below zero indicate the opposite (Bearish).