Three Outside Up/Down Candlestick Pattern
Category: Candlestick patterns · Updated November 2026
The TAAPI.IO Three Outside Up/Down API returns whether the pattern appeared on each candle for the Three Outside Up/Down 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/3outside |
| Outputs | value |
| Markets | Binance, Binance Futures, Bybit, Gate.io, Kraken and US stocks |
| Timeframes | 1m to 1w |
| Delivery | REST, bulk and WebSocket |
Get Three Outside Up/Down with one API call
This request returns Three Outside Up/Down for BTCUSDT on 1-hour Binance candles. Add your API key to run it here.
curl -G https://v2.taapi.io/indicator/3outside \ -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/3outside',
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/3outside?${params}`, {
headers: { Authorization: 'Bearer YOUR_API_KEY' },
});
console.log(await res.json());Three Outside Up/Down API response
This response came from the live API on 9 November 2026. Long lists are shortened here.
{
"value": [0],
"timestamp": [1794218400]
}| Field | Type | Description |
|---|---|---|
value | number[] | Three Outside Up/Down result |
timestamp | integer[] | Unix time of each candle, in seconds |
Three Outside Up/Down 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 Three Outside Up/Down?
Three Outside Up/Down is a 3-candle Japanese candlestick pattern. An engulfing pattern forms on the first two candles, then the third candle closes further in the same direction. It works as a confirmed version of the engulfing pattern.
How to read Three Outside Up/Down in your code
| Signal | Meaning | Condition |
|---|---|---|
| Bullish | Bullish variant completed on this candle | value > 0 |
| Bearish | Bearish variant 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 Three Outside Up/Down 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/3outside \ -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/3outside',
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 Three Outside Up/Down 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/3outside \ -H "Authorization: Bearer YOUR_API_KEY" \ --data-urlencode "exchange=binance" \ --data-urlencode "symbol=BTCUSDT" \ --data-urlencode "timeframe=1h" \ --data-urlencode "results=100"
Get Three Outside Up/Down for multiple symbols
Combine Three Outside Up/Down 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.
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": "3outside",
"indicator": "3outside"
},
{
"id": "rsi",
"indicator": "rsi"
}
]
}
]
}'Stream Three Outside Up/Down 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.
{
"type": "subscribe",
"id": "3outside",
"exchange": "binance",
"symbol": "BTCUSDT",
"interval": "1m",
"indicator": "3outside"
}Three Outside Up/Down API FAQ
What does the Three Outside Up/Down API return?
It returns value, plus a timestamp for the request. Results are JSON.
What do the Three Outside Up/Down values mean?
0 means no pattern. A non-zero value means it was detected and is positive when bullish and negative when bearish. 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 Three Outside Up/Down for US stocks?
Yes. Use exchange=stocks with a ticker such as AAPL. US stocks are included on the Pro plan and above.
Related indicators
See the full list of indicators, or start for free.