QuanTAlib/lib/momentum/apo/Apo.md

APO: Absolute Price Oscillator

Percentages are for analysts. Traders pay bills in cash. APO tells you the cash value of the trend.

The Absolute Price Oscillator (APO) measures the raw currency difference between two exponential moving averages. Unlike its percentage-based cousin (PPO), APO speaks in dollars and cents, making it the preferred tool for spread traders, arbitrageurs, and anyone whose P&L is denominated in currency rather than basis points.

The Cash Reality

A $5 move on a $100 stock (5%) feels different than a $5 move on a $20 stock (25%), but to a spread trader balancing a hedge, $5 is $5. Percentage oscillators distort this reality.

APO strips away the normalization. It simply asks: "How far is the fast trend from the slow trend in absolute terms?" This provides a direct read on the cash momentum of the asset.

Architecture & Physics

APO is built on the foundation of our high-performance Ema kernel. It inherits the O(1) computational complexity and zero-allocation characteristics of the underlying moving averages.

1. Dual EMA Engine: We maintain two independent Exponential Moving Averages (Fast and Slow).
2. Differential: We compute the arithmetic difference between them.
3. SIMD Acceleration: For batch processing, we use hardware intrinsics to perform the subtraction across the entire dataset in parallel.

Computational Efficiency

We don't recalculate the EMAs from scratch. We maintain the state of both the fast and slow EMAs, allowing us to compute the APO update in constant time, regardless of the lookback period.

• Time Complexity: O(1) per update.
• Space Complexity: O(1) (two EMA state structs).
• Allocations: 0 bytes on the hot path.

Mathematical Foundation

The formula is the definition of simplicity.

APO_t = EMA(P, n_{fast}) - EMA(P, n_{slow})

Where:

• EMA is the recursive Exponential Moving Average.
• n_{fast} is the fast period (default 12).
• n_{slow} is the slow period (default 26).

Performance Profile

APO performance is effectively the sum of two EMA calculations plus a subtraction.

Metric	Complexity	Notes
Throughput	~15ns / bar	Sum of two EMA updates
Allocations	0 bytes	Hot path is allocation-free
Batch	SIMD	Uses SimdExtensions.Subtract for vectorization
Precision	double	Standard floating-point precision

Validation

We validate our implementation against industry standards to ensure correctness.

• TA-Lib: Matches APO with MAType.Ema (Precision: 1e-9).
• Tulip: Note that Tulip's default apo may use SMA or different defaults; we strictly adhere to the EMA-based definition used by TA-Lib and major trading platforms.

Common Pitfalls

• Scale Sensitivity: APO values are not normalized. An APO of 10.0 on Bitcoin is noise; on EUR/USD, it's a catastrophe. Use PPO for cross-asset comparisons.
• Lag: As a derivative of moving averages, APO lags price. The lag is a function of the slow period.