Indicators›Candlestick patterns›Belt-hold

GET/indicator/belthold

Belt-hold Candlestick Pattern

Category: Candlestick patterns · Updated November 2026

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

Get Belt-hold with one API call

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

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

Belt-hold 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[]	Belt-hold result
`timestamp`	integer[]	Unix time of each candle, in seconds

Belt-hold 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 Belt-hold?

Belt-hold is a 1-candle Japanese candlestick pattern. A long candle that opens at its extreme: at the low for a bullish candle or at the high for a bearish one. It is read as a strong open against the prior direction.

How to read Belt-hold 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 Belt-hold 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/belthold \
  -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/belthold',
    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 Belt-hold 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/belthold \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "exchange=binance" \
  --data-urlencode "symbol=BTCUSDT" \
  --data-urlencode "timeframe=1h" \
  --data-urlencode "results=100"

Get Belt-hold for multiple symbols

Combine Belt-hold 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": "belthold",
          "indicator": "belthold"
        },
        {
          "id": "rsi",
          "indicator": "rsi"
        }
      ]
    }
  ]
}'

Stream Belt-hold 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": "belthold",
  "exchange": "binance",
  "symbol": "BTCUSDT",
  "interval": "1m",
  "indicator": "belthold"
}

Belt-hold API FAQ

What does the Belt-hold API return?

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

What do the Belt-hold 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 Belt-hold 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.