Indicators›Candlestick patterns›Unique Three River

GET/indicator/unique3river

Unique Three River Candlestick Pattern

Category: Candlestick patterns · Updated November 2026

The TAAPI.IO Unique Three River API returns whether the pattern appeared on each candle for the Unique 3 River candlestick pattern 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/unique3river`
Outputs	`value`
Markets	Binance, Binance Futures, Bybit, Gate.io, Kraken and US stocks
Timeframes	`1m` to `1w`
Delivery	REST, bulk and WebSocket

Get Unique Three River with one API call

This request returns Unique Three River for BTCUSDT on 1-hour Binance candles. Add your API key to run it here.

curl -G https://v2.taapi.io/indicator/unique3river \
  -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/unique3river',
    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/unique3river?${params}`, {
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
});
console.log(await res.json());

Unique Three River API response

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

200 OK

{
  "value": [0],
  "timestamp": [1794218400]
}

Field	Type	Description
`value`	number[]	Unique Three River result
`timestamp`	integer[]	Unix time of each candle, in seconds

Unique Three River 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`
`results`	integer	No	1	Number of values to return, or `max`
`backtrack`	integer	No	0	Candles to skip from the most recent

What is Unique Three River?

Unique Three River is a 3-candle bullish Japanese candlestick pattern. A long black candle, a harami with a lower low, then a small white candle closing under the second candle's close. It is a rare bottoming pattern.

How to read Unique Three River in your code

Signal	Meaning	Condition
Detected	Pattern completed on this candle	`value` > 0
Not detected	No pattern on this candle	`value` equals 0

Limitations: Candlestick patterns describe what already happened and are more meaningful alongside trend and volume. On 24/7 crypto markets there are few real gaps between candles, so gap-based patterns occur less often than on stocks. Nothing on this page is financial advice.

Detect Unique Three River with Python

Check the last closed candle by adding backtrack=1. A pattern on the candle still forming can disappear before it closes.

curl -G https://v2.taapi.io/indicator/unique3river \
  -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/unique3river',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={'exchange': 'binance', 'symbol': 'BTCUSDT', 'timeframe': '1h', 'results': 2, 'backtrack': 1},
)
data = resp.json()
signal = data['value'][-1]

if signal > 0:
    print('Bullish pattern on the last closed candle')
elif signal < 0:
    print('Bearish pattern on the last closed candle')
else:
    print('No pattern')

Get historical Unique Three River 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/unique3river \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "exchange=binance" \
  --data-urlencode "symbol=BTCUSDT" \
  --data-urlencode "timeframe=1h" \
  --data-urlencode "results=100"

Get Unique Three River for multiple symbols

Combine Unique Three River 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": "unique3river",
          "indicator": "unique3river"
        },
        {
          "id": "rsi",
          "indicator": "rsi"
        }
      ]
    }
  ]
}'

Stream Unique Three River 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": "unique3river",
  "exchange": "binance",
  "symbol": "BTCUSDT",
  "interval": "1m",
  "indicator": "unique3river"
}

Unique Three River API FAQ

What does the Unique Three River API return?

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

What do the Unique Three River values mean?

0 means no pattern. A non-zero value means it was detected and is a positive number (bullish). TA-Lib patterns commonly return 100 or −100, and some return other values such as 80 or −80, so check the sign and not an exact number.

Can I get Unique Three River 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.