Skip to main content
GET
Get candles

Authorizations

Authorization
string
header
required

Bearer access token issued by /v1/auth/* login endpoints.

Path Parameters

symbol
string
required

Trading symbol

Query Parameters

timeframe
string
required

Timeframe

startTime
integer<int64>

Start time in milliseconds since Unix epoch

endTime
integer<int64>

End time in milliseconds since Unix epoch

limit
integer<int64>

Max number of candles (default: 2500)

enableExternalSource
boolean

Opt-in external candles stored in the DB (default: false)

Response

Asset candles

close
number<double>
required
high
number<double>
required
low
number<double>
required
open
number<double>
required
time
integer<int64>
required

Candle timestamp as a Unix timestamp in milliseconds (UTC).

externalSource
string | null

External candle source name (e.g., "binance", "coinbase"). Omitted from JSON for exchange candles to preserve backward compatibility.

markClose
number<double>
markHigh
number<double>
markLow
number<double>
markOpen
number<double>
tradeCount
integer<int64> | null
Required range: x >= 0
volume
number<double> | null
volumeQuote
number<double> | null

Quote currency volume (e.g. USDC) for the candle period.