# Oscillator (OSCILLATOR)

> QuantNexus indicator page for acceleration-based oscillator movement.

**Route**: `/quantnexus/indicators/oscillator/`

## What It Does

OSCILLATOR tracks trend acceleration using an acceleration-factor model with configurable step and cap values.

## Formula

The oscillator updates a running value using `period`, `af`, and `afmax` to control the rate of change and maximum acceleration.

## Parameters

- `period` - default `2`
- `af` - default `0.02`
- `afmax` - default `0.2`

## C++23 API

```cpp
#include <nonabt/indicators/oscillator.hpp>
auto osc = std::make_unique<nonabt::OSCILLATOR>(data().close(), 2, 0.02, 0.2);
```

## Common Usage

- Use it to track trend acceleration and possible reversals.
- Pair it with a price cross or a directional filter.
- Best used as a confirmation layer, not a standalone trigger.