Williams %R

Indicators

• Price
• High
• Low

Williams %R

14 candles

• %R
• oversold
• overbought

This is how the node looks on the board: inputs on the left, outputs on the right.

Close near the high or low, −100 to 0. Like the stochastic, shows where the close sits within the range of the last candles, but on a scale from −100 to 0: 0 means at the highest high, −100 at the lowest low. Above −20 the price closes near the high (overbought), below −80 near the low (oversold); the “overbought” and “oversold” outputs report this, and you drag the thresholds in the chart below the price. Example: “Williams %R 14 crosses above −80” fires when the price pulls away from the low after a sell-off.

What it looks like

• Price (close of each candle)
• Williams %R 14
• below −80 and above −20
• crosses above −80

Top: the price; bottom: Williams %R 14 of the same 1-hour candles. 0 means a close at the high of the last 14 candles, −100 at the low. At the dots the line rises from below −80 back above it: the price pulls away from the low.

Setting it in the chart

The properties show the price of the last 150 candles at the top and Williams %R below it, with the zone between the thresholds. Drag a threshold or type it; the number in the field follows in whole steps. Dots on the price show where “oversold” or “overbought” would be true, the top line shows how often.

More under Chart below the price.

Settings

The settings appear on the right under “Properties” once you click the node on the board. Below each field you find the same explanation as here.

Candles

Default: 14 · from 2 to 200, whole number

How many candles the highest high and the lowest low are taken from. 14 is the usual value. Fewer candles make the line faster and jumpier, more candles calmer.

Oversold below

Default: -80 · from -100 to 0

Below this line the price closes near the lowest low of the last candles, and the “oversold” output is true. −80 is usual.

Overbought above

Default: -20 · from -100 to 0

Above this line the price closes near the highest high of the last candles, and the “overbought” output is true. −20 is usual.

Example

Notifies you when Williams %R rises from below −80 back above it, so ETH pulls away from the low of the last 14 candles.

How to connect the nodes:

1. Candle (Price) → Williams %R (Price)
2. Candle (High) → Williams %R (High)
3. Candle (Low) → Williams %R (Low)
4. Williams %R (%R) → Compare (Value)
5. Compare (true/false) → Push (Trigger)

On the board it reads: 14 candles

Chain as JSON

To try it, copy it and paste it in the editor under “Import”. Importing creates a new chain.

willr.json

{
  "name": "Example: Williams %R",
  "version": 1,
  "nodes": [
    { "id": "c1", "type": "core.candle", "position": { "x": 40, "y": 40 }, "settings": { "pair": "ETH/USDT", "timeframe": "1h" } },
    { "id": "w1", "type": "core.willr", "position": { "x": 260, "y": 40 }, "settings": {} },
    { "id": "k1", "type": "core.compare", "position": { "x": 480, "y": 40 }, "settings": { "operator": "crossesAbove", "value": -80 } },
    { "id": "p1", "type": "core.push", "position": { "x": 700, "y": 40 }, "settings": {} }
  ],
  "edges": [
    { "from": "c1.close", "to": "w1.close" },
    { "from": "c1.high", "to": "w1.high" },
    { "from": "c1.low", "to": "w1.low" },
    { "from": "w1.out", "to": "k1.in" },
    { "from": "k1.out", "to": "p1.in" }
  ]
}

Inputs and outputs

Only matching types connect: number series to number series (round pin), signal to signal (square), message to message (diamond).

Direction	Pin	Type	Note
Input	Price	Number series	required
Input	High	Number series	required
Input	Low	Number series	required
Output	%R	Number series	–
Output	oversold	Signal (true/false)	–
Output	overbought	Signal (true/false)	–

Good to know

• In messages the value is called “Williams %R 14”.
• Warm-up with the default settings: 14 candles (this many extra candles are loaded by the replay before the value is reliable).
• Search also finds it under: williams %r, williams, wpr, oscillator, overbought, oversold.

Technical details

100 · (close − highest high) / (highest high − lowest low) over the candles, empty when high and low are equal; the same formula as ta.wpr in TradingView.

• Type in the chain: core.willr · Version 1.0.0 · Category key ind
• Settings in the chain: length (Candles), oversold (Oversold below), overbought (Overbought above)
• Pins in the chain: Input close, high, low · Output out, oversold, overbought
• Reference tests in the manifest: 2 (with fixed price data: 500 candles of 1h)
• How a node is built