Get historical OHLCV candles

Retrieve historical market data (Open, High, Low, Close, Volume) for a specific symbol. If there is trading volume, the view is based on recent trades. If there is no volume, the view is based on the Mid Price (Bid/Ask average).

Request​

Path parameters
Path parameters

The trading pair symbol (e.g., BTC-USD).

Query parameters
Query parameters

Possible values: [5, 15, 30, 60, 240, 1440, 2880, 5760, 10080, 20160, 40320]
Example: 5

Default value: 5

Time interval between candles in minutes.

Example: 3318215482991

Start timestamp for the query in Unix epoch milliseconds.

Logic:

  • If not provided, returns the last 100 candles based on the interval.
  • If provided, but the range is too large, results will be truncated to the last 100 candles before current timestamp.
Header parameters
Header parameters

Example: 1746007718237

Current timestamp in Unix epoch milliseconds. Used to prevent replay attacks and construct the signature. Provided with other authentication headers.

Example: "2h/t5o8w+l5s+fjyfA0n/e7j4u5b7h4e+g4k4c8h7a2p6k0g7j1f+w0i2j3k9r0l3s8m5t6r+q1s+o3v/t4x8v5y+w1r+m2t/k3w/j4y+"

The Ed25519 signature of the request. Provided with other authentication headers.

Tip

See Authentication headers: Signing a request for details on how to generate this.

Response​

OK

List of OHLCV candles.

Response body
Body object

Start timestamp of the candle in Unix epoch milliseconds.

Opening price.

Highest price during the interval.

Lowest price during the interval.

Closing price.

Total trading volume during the interval.
Was this page helpful?