Doji Candlestick Pattern

Category: Candlestick patterns · Updated November 2026

The TAAPI.IO Doji API tells you, candle by candle, whether a candle is a doji: a candle that opens and closes at almost the same price. It works on crypto pairs and US stocks. Send an exchange, symbol and timeframe and get 100 for a doji and 0 for any other candle, with no candles to download and no pattern logic to maintain.

What one request returns

• One value per candle: 100 when the candle's body is tiny compared with recent candles, 0 otherwise. A doji has no direction, so the value is never negative.
• The candle's timestamp, so you can match each value to its candle.
• The rule: the body (|close − open|) must be at most 10% of the average high-to-low range of the 10 candles before it.

The default returns the newest candle, which is usually still forming. Add backtrack=1 for the last closed candle, or results to get a series.

Get Doji with one API call

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

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

Doji API response

The request above with results=10 added, from the live API on 12 November 2026 at 11:17 UTC. The candle at 03:00 UTC (1794452400) was a doji. The last element, 11:00 UTC, was the candle still forming.

{
  "value": [0, 100, 0, 0, 0, 0, 0, 0, 0, 0],
  "timestamp": [1794448800, 1794452400, 1794456000, 1794459600, 1794463200, 1794466800, 1794470400, 1794474000, 1794477600, 1794481200]
}

Without results you still get arrays, each with one element.

Doji API parameters

Doji has no settings of its own: the 10-candle average and the 10% threshold are fixed.

What is a Doji?

A doji is a single candle whose open and close are almost the same, so the body is a thin line. Buyers and sellers both pushed price around during the candle and ended where they started: the market could not decide. The wicks tell you how far each side got. A doji with a long lower wick is a Dragonfly Doji, with a long upper wick a Gravestone Doji, and with long wicks on both sides a Long Legged Doji. This endpoint flags all of them, since it only looks at the body.

Why it matters

Indecision means something only when it interrupts conviction. After a strong move down, a doji shows the selling pressure has stalled; after a strong move up, the buying. That makes it a possible reversal warning, not a signal on its own. In a sideways market dojis are common and mean very little. Traders usually wait for the next candle: a close above the doji's high after a downtrend, or below its low after an uptrend, before acting.

How the API decides

Because the yardstick is the recent average and not the candle's own range, a candle with a small body can miss after a quiet stretch (4 June above), and ordinary-looking candles can qualify right after a volatile one. Wicks don't count at all. We checked the live output against this rule on 1,190 candles across BTC, ETH, SOL, AAPL and SPY on timeframes from 15 minutes to 1 day, with no differences.

How to read Doji in your code

Mind the newest candle. Without backtrack, the last value belongs to the candle that is still forming. Its open is fixed but its close is just the latest price, so a 100 can turn into 0 a minute later, and the other way round. Use backtrack=1 to read only closed candles.

Limitations: Dojis are frequent. In our checks the API flagged 15 to 21% of candles, about one in seven on BTCUSDT 1h, so always add context such as a prior trend, a support level or volume. The pattern looks at one candle at a time and knows nothing about trend. Very short timeframes and quiet hours produce many dojis that mean nothing. Each value needs the 10 candles before it. Nothing on this page is financial advice.

Detect a confirmed Doji with Python

This checks the last two closed candles: was the first a doji, had price fallen before it, and did the second close above its high? backtrack=1 on both requests keeps the forming candle out, and the two responses line up candle for candle.

curl -G https://v2.taapi.io/indicator/doji \
  -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

API = 'https://v2.taapi.io'
HEADERS = {'Authorization': 'Bearer YOUR_API_KEY'}
market = {'exchange': 'binance', 'symbol': 'BTCUSDT', 'timeframe': '1h', 'backtrack': 1}

# Last 2 closed candles: the possible doji, then the confirmation candle
doji = requests.get(f'{API}/indicator/doji', headers=HEADERS,
                    params={**market, 'results': 2}).json()
# Last 10 closed candles, oldest first
candles = requests.get(f'{API}/candles', headers=HEADERS,
                       params={**market, 'results': 10}).json()

doji_candle, next_candle = candles[-2], candles[-1]

is_doji = doji['value'][-2] == 100
fell_before = doji_candle['close'] < candles[0]['close'] * 0.97  # down 3%+ over 8 candles
confirmed = next_candle['close'] > doji_candle['high']

if is_doji and fell_before and confirmed:
    print('Doji after a fall, confirmed by a close above its high')
elif is_doji:
    print('Doji, but no downtrend or no confirmation yet')
else:
    print('No doji on the previous candle')

Get historical Doji values

Add results to return a series for backtesting or charting. The last element is the most recent candle. Fetch the same number of candles to draw them: the timestamps match.

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

Get Doji for multiple symbols

Combine Doji 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": "doji",
          "indicator": "doji"
        },
        {
          "id": "rsi",
          "indicator": "rsi"
        }
      ]
    }
  ]
}'

Stream Doji 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. Streamed values are for the forming candle, so they can flip until it closes.

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

Doji API FAQ

Related indicators

• Dragonfly Doji
• Gravestone Doji
• Long Legged Doji
• Doji Star
• Spinning Top

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