Market Data

Fetch raw OHLCV (open, high, low, close, volume) candlestick data directly from the exchange cache. Use this endpoint to render charts, seed backtests, or build candle arrays for manual indicator calculations.

Endpoint

GET https://v2.taapi.io/candles
Authorization: Bearer YOUR_API_KEY

Parameters

Parameter	Required	Default	Description
`exchange`	✅	—	Exchange identifier — e.g. `binance`, `bybit`
`symbol`	✅	—	Trading pair — e.g. `BTCUSDT`, `ETHUSDT`
`timeframe`	✅	—	Candle interval: `1m` `5m` `15m` `1h` `4h` `1d` `1w`
`results`	—	`1`	Number of candles to return. Use `max` to return all available.
`backtrack`	—	`0`	Number of candles to skip from the most recent result

Response

Returns a plain array of OHLCV candle objects, ordered oldest to newest:

[
  {
    "timestamp": 1708300800,
    "timestampHuman": "2024-02-19 00:00:00",
    "open": 51200.50,
    "high": 52100.00,
    "low": 50900.25,
    "close": 51850.75,
    "volume": 1234.56
  },
  {
    "timestamp": 1708304400,
    "timestampHuman": "2024-02-19 01:00:00",
    "open": 51850.75,
    "high": 52500.00,
    "low": 51700.00,
    "close": 52200.00,
    "volume": 987.32
  }
]

Example request

GET https://v2.taapi.io/candles
    ?exchange=bybit
    &symbol=BTCUSDT
    &timeframe=1h
    &results=3
Authorization: Bearer YOUR_API_KEY

Error codes

Status	Cause
`400 Bad Request`	Missing required parameter, invalid symbol, or unsupported exchange
`401 Unauthorized`	API key missing or invalid
`429 Too Many Requests`	Rate limit exceeded — see Rate Limits

Using candles for manual calculation

Once you have a candle array you can pass it directly to any indicator endpoint for offline computation — no live exchange connection needed. See Manual Candle Injection for the full guide.

Was this page helpful? Send us feedback or open a support ticket.