API Reference
SupportStatusSign UpLogin
Start typing to search…

Get OHLCV by Symbol - Batch

get
https://api.tatum.io/v4/data/rate/symbol/OHLCV/batch

/v4/data/rate/symbol/OHLCV/batch

500 credits per API call

Get multiple historical OHLCV (Open, High, Low, Close, Volume) candles for a symbol starting from a given time.

Returns up to numberOfCandles (max 50) OHLCV candles with openTime ≥ the provided start time, ordered by openTime ascending. The optional interval query parameter sets the candle size (same values as GET /v4/data/rate/symbol/OHLCV); it defaults to 1m.

Supported symbols: We support 439+ trading pairs. The symbol parameter accepts the base currency (e.g., "BTC", "ETH").

Time format: Provide the start of the range either as a Unix timestamp in milliseconds (unixFrom) or as a Date in ISO 8601 format (timeFrom). You must provide exactly one of these parameters.

Query Params
string
enum
required

The base symbol of the trading pair (e.g., "BTC", "ETH").

integer
≥ 0

Start time as Unix timestamp in milliseconds. Either unixFrom or timeFrom must be provided, but not both.

date-time

Start time in ISO 8601 format. Either unixFrom or timeFrom must be provided, but not both.

integer
required
1 to 50

Number of candles to return (1 to 50).

string
enum

Candle interval. Supported values: 1m, 5m, 15m, 30m, 45m, 1h, 2h, 4h, 1d, 1w, 1M. Defaults to 1m.

Responses

400

Bad Request - Invalid parameters (e.g., both unixFrom and timeFrom provided, or neither provided, or invalid symbol, or numberOfCandles out of range).

403

Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.

Updated 13 days ago

Language
Credentials
Header
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 13 days ago