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

# Get order book V2

Retrieve the current public order book snapshot (bids and asks) for a specific trading pair.

Provide `region` to retrieve the order book for a specific region.
The resolved region is returned in `metadata.region`.

## Endpoint

GET `/2.0/public/order-book/{symbol}`

## Parameters

### path parameters

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

### query parameters

- `limit` (integer, optional)
  Depth of the order book to return (number of levels).

- `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

The public Order Book snapshot for the given trading pair.

#### Response attributes

- `data` (object)
  - `data.asks` (array of object)
      The list of asks (sell orders), sorted by price in descending order.
    - `data.asks[].price` (string)
        Price at this level.
    - `data.asks[].quantity` (string)
        Aggregated quantity at this price level.
    - `data.asks[].count` (integer)
        Number of orders at the price level.
  - `data.bids` (array of object)
      The list of bids (buy orders), sorted by price in descending order.
    - `data.bids[].price` (string)
        Price at this level.
    - `data.bids[].quantity` (string)
        Aggregated quantity at this price level.
    - `data.bids[].count` (integer)
        Number of orders at the price level.
- `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 order book snapshot was generated, returned in Unix epoch milliseconds.

## Error responses

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