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).

Note

To use this feature, you need an API key generated in the Revolut X web app. Please join the waitlist to get access.

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.

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.