# Williams %R (WILLR)

> QuantNexus indicator page for Williams %R.

**Route**: `/quantnexus/indicators/willr/`

## What It Does

Williams %R is a momentum oscillator that compares the close to the recent high-low range. It is often used to identify overbought and oversold conditions.

## Formula

`Williams %R = -100 * (Highest High - Close) / (Highest High - Lowest Low)`

## Parameters

- `period` - default `14`
- `upperband` - default `-20`
- `lowerband` - default `-80`

## C++23 API

```cpp
#include <nonabt/indicators/willr.hpp>
auto willr = std::make_unique<nonabt::WILLR>(data(), 14, -20, -80);
```

## Common Usage

- Use Williams %R to spot overbought and oversold conditions.
- Combine it with trend filters to avoid fading strong directional moves too early.
- Similar in spirit to Stochastic, but centered on the close within the high-low range.

## Practical Pattern

When Williams %R is near `-80`, the market may be oversold; near `-20`, it may be overbought.