---
api: 'Revolut X Crypto Exchange REST API'
---

# Get public historical OHLCV candles

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

Provide `region` to retrieve candles for a specific region.
The resolved region is returned in `metadata.region`.

## Endpoint

GET `/1.0/public/candles/{symbol}`

## Parameters

### path parameters

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

### query parameters

- `interval` (enum, optional)
  Time interval between candles in minutes.
  Possible enum values:

  - `1`
  - `5`
  - `15`
  - `30`
  - `60`
  - `240`
  - `1440`
  - `2880`
  - `5760`
  - `10080`
  - `20160`
  - `40320`

- `since` (integer, optional)
  Start timestamp for the query in Unix epoch milliseconds.
  
  :::note
  If omitted, up to 1000 candles leading up to the `until` parameter will be returned.
  :::

- `until` (integer, optional)
  End timestamp for the query in Unix epoch milliseconds.
  
  :::note
  If omitted, this defaults to the current timestamp.
  :::

- `region` (enum, optional)
  Region for market data retrieval. Defaults to EEA if omitted.
  Use UK to retrieve data from the UK region.
  Possible enum values:

  - `UK`
  - `EEA`

## Returns

### 200

OK

List of OHLCV candles.

#### Response attributes

- `data` (array of object)
  - `data[].start` (integer)
      Start timestamp of the candle in Unix epoch milliseconds.
  - `data[].open` (string)
      Opening price.
  - `data[].high` (string)
      Highest price during the interval.
  - `data[].low` (string)
      Lowest price during the interval.
  - `data[].close` (string)
      Closing price.
  - `data[].volume` (string)
      Total trading volume during the interval, expressed in base currency volume.
- `metadata` (object)
  - `metadata.region` (enum)
      Region from which the public market data was retrieved.
      Possible enum values:

      - `UK`
      - `EEA`
  - `metadata.timestamp` (integer)
      Timestamp when the data was generated, in Unix epoch milliseconds.

## Error responses

| HTTP status code | Description |
| --- | --- |
| 400 | Bad request |
| 429 | Rate Limit Exceeded |
| 5XX | Server Error |