GET/indicator/willr

Williams %R

Category: Momentum · Updated November 2026

The TAAPI.IO Williams %R API returns real-time and historical values for the Williams %R indicator as JSON, for crypto pairs and US stocks. Send an exchange, symbol and timeframe to get real-time or historical data, with no candles to download and no calculations to maintain.

Spec	Value
Endpoint	`GET https://v2.taapi.io/indicator/willr`
Outputs	`value`
Markets	Binance, Binance Futures, Bybit, Gate.io, Kraken and US stocks
Timeframes	`1m` to `1w`
Delivery	REST, bulk and WebSocket

Get Williams %R with one API call

This request returns Williams %R for BTCUSDT on 1-hour Binance candles. Add your API key to run it here.

curl -G https://v2.taapi.io/indicator/willr \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "exchange=binance" \
  --data-urlencode "symbol=BTCUSDT" \
  --data-urlencode "timeframe=1h"

import requests

resp = requests.get(
    'https://v2.taapi.io/indicator/willr',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={'exchange': 'binance', 'symbol': 'BTCUSDT', 'timeframe': '1h'},
)
print(resp.json())

const params = new URLSearchParams({"exchange": "binance", "symbol": "BTCUSDT", "timeframe": "1h"});
const res = await fetch(`https://v2.taapi.io/indicator/willr?${params}`, {
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
});
console.log(await res.json());

Williams %R API response

This response came from the live API on 9 November 2026. Long lists are shortened here.

200 OK

{
  "value": [-74.04560695749974],
  "timestamp": [1794218400]
}

Field	Type	Description
`value`	number[]	Williams %R result
`timestamp`	integer[]	Unix time of each candle, in seconds

Williams %R API parameters

Name	Type	Required	Default	Description
`exchange`	string	Yes	—	`binance`, `binancefutures`, `bybit`, `gateio`, `kraken` or `stocks`
`symbol`	string	Yes	—	Pair or ticker, e.g. `BTCUSDT` or `AAPL`
`timeframe`	string	Yes	—	`1m` `5m` `15m` `1h` `4h` `1d` `1w`
`period`	integer	No	14	Time Period
`results`	integer	No	1	Number of values to return, or `max`
`backtrack`	integer	No	0	Candles to skip from the most recent

What is Williams %R?

Williams %R, created by Larry Williams, shows where the close sits relative to the highest high of a window, on an inverted scale from −100 to 0. It is effectively an inverted fast stochastic.

Williams %R formula

Output	Calculation
%R	(highest high − close) ÷ (highest high − lowest low) × −100

How to read Williams %R in your code

Signal	Meaning	Condition
Overbought	Close near the top of the range	`value` above −20
Oversold	Close near the bottom of the range	`value` below −80

Limitations: The negative scale catches many developers out: −10 is overbought and −90 is oversold. It stays at the extremes during strong trends. Nothing on this page is financial advice.

Compare the last two closed Williams %R values

Use backtrack=1 to skip the candle still forming, and results=2 to compare the last two closed candles. Arrays run oldest first.

curl -G https://v2.taapi.io/indicator/willr \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "exchange=binance" \
  --data-urlencode "symbol=BTCUSDT" \
  --data-urlencode "timeframe=1h" \
  --data-urlencode "results=2" \
  --data-urlencode "backtrack=1"

import requests

resp = requests.get(
    'https://v2.taapi.io/indicator/willr',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={'exchange': 'binance', 'symbol': 'BTCUSDT', 'timeframe': '1h', 'results': 2, 'backtrack': 1},
)
data = resp.json()
prev, last = data['value']
print('value', prev, '->', last)
print('rising' if last > prev else 'falling or flat')

Get historical Williams %R values

Add results to return a series for backtesting or charting. The last element is the most recent candle.

curl -G https://v2.taapi.io/indicator/willr \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "exchange=binance" \
  --data-urlencode "symbol=BTCUSDT" \
  --data-urlencode "timeframe=1h" \
  --data-urlencode "results=100"

Get Williams %R for multiple symbols

Combine Williams %R with other indicators in one request. Each exchange, symbol and timeframe combination is one construct: Basic allows 1 per request, Pro 3 and Expert 10.

POST/bulk

curl -X POST https://v2.taapi.io/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "constructs": [
    {
      "id": "btc_1h",
      "exchange": "binance",
      "symbol": "BTCUSDT",
      "timeframe": "1h",
      "indicators": [
        {
          "id": "willr",
          "indicator": "willr"
        },
        {
          "id": "rsi",
          "indicator": "rsi"
        }
      ]
    }
  ]
}'

Stream Williams %R in real time

Subscribe over WebSocket to receive new values every 5 seconds while the candle is forming. Streaming supports 1m, 5m, 15m and 1h, and uses interval where REST uses timeframe.

WSSwss://v2.taapi.io/streaming

{
  "type": "subscribe",
  "id": "willr",
  "exchange": "binance",
  "symbol": "BTCUSDT",
  "interval": "1m",
  "indicator": "willr"
}

Williams %R API FAQ

What does the Williams %R API return?

It returns value, plus a timestamp for the request. Results are JSON.

Is the latest Williams %R value final?

No. The newest value belongs to the candle still forming and can change until it closes. Add backtrack=1 to read the last closed candle.

Which Williams %R settings can I change?

You can set period. See the parameters table above for defaults.

Can I get Williams %R for US stocks?

Yes. Use exchange=stocks with a ticker such as AAPL. US stocks are included on the Pro plan and above.

See the full list of indicators, or start for free.