Markets

Get historical candles for a market

Retrieve historical candlestick (OHLCV) data for a specific market over a given time range and interval.

GET
/markets/{mkt_id}/candles

Authorization

ApiKeyAuth ApiSignatureAuth ApiTimestampAuth
x-api-key<token>

API key for authentication

In: header

x-api-signature<token>

HMAC-SHA256 signature: base64(HMAC(timestamp + method + path + body, secret))

In: header

x-api-timestamp<token>

Unix timestamp in seconds

In: header

Path Parameters

mkt_id*string

Market ID (e.g., "BTC-PERP", "ETH-PERP").

Query Parameters

intv?string

Candle interval duration in nanoseconds (default: 1 hour if not set).

Formatint64
start_ts?string

Start time in nanoseconds (default: now() - 1 hour if not set).

Formatint64
end_ts?string

End time in nanoseconds (default: now() if not set).

Formatint64

Response Body

application/json