GET/candles

Candlestick (OHLCV) Data

Category: Market data · Updated November 2026

The TAAPI.IO Candles API returns open, high, low, close and volume candles as JSON for crypto pairs and US stocks. Send an exchange, symbol and timeframe to get the latest or historical candles for charting, backtesting and your own calculations.

Spec	Value
Endpoint	`GET https://v2.taapi.io/candles`
Outputs	`open`, `high`, `low`, `close`, `volume`, `timestamp`, `timestampHuman`
Markets	Binance, Binance Futures, Bybit, Gate.io, Kraken and US stocks
Timeframes	`1m` to `1w`

Get OHLCV candles with one API call

This request returns the last two closed 1-hour BTCUSDT candles from Binance. Add your API key to run it here.

curl -G https://v2.taapi.io/candles \
  -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/candles',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={'exchange': 'binance', 'symbol': 'BTCUSDT', 'timeframe': '1h', 'results': 2, 'backtrack': 1},
)
for candle in resp.json():
    print(candle['timestampHuman'], candle['open'], candle['high'], candle['low'], candle['close'], candle['volume'])

Candles API response

This response came from the live API on 9 November 2026. Unlike indicator endpoints, the result is an array of candle objects, oldest first.

200 OK

[
  {
    "open": 74288.01,
    "high": 74354.01,
    "low": 74058.45,
    "close": 74163.76,
    "volume": 429.7149799999998,
    "timestamp": 1794218400,
    "timestampHuman": "2026-11-09 10:00:00"
  },
  {
    "open": 74163.76,
    "high": 74818.26,
    "low": 74058.7,
    "close": 74372.01,
    "volume": 592.77175,
    "timestamp": 1794222000,
    "timestampHuman": "2026-11-09 11:00:00"
  }
]

Candles 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 candles to return, or `max`
`backtrack`	integer	No	0	Candles to skip from the most recent

What is OHLCV data?

Each candle summarises trading over one timeframe: the first price (open), highest price (high), lowest price (low), last price (close) and the amount traded (volume). Almost every technical indicator is calculated from these five numbers.

Get historical candles

Add results to return a series for backtesting or charting. See the Candles reference for details and limits.

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

Candles API FAQ

What does the Candles API return?

A JSON array of candles, oldest first. Each has open, high, low, close, volume, timestamp and timestampHuman.

Is the newest candle complete?

No. The newest candle is still forming and can change. Add backtrack=1 to end on the last closed candle.

Can I get candles for US stocks?

Yes. Use exchange=stocks with a ticker such as AAPL. US stocks are included on the Pro plan and above.

Can I calculate indicators on my own candles?

Yes. Manual candles let you send your own OHLCV data and get indicators back.

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