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

# Get order book

Fetch the current order book (bids and asks) for a given trading pair (with a maximum of 5 price levels).

## Endpoint

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

## Parameters

### path parameters

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

## Returns

### 200

OK

The Order Book snapshot for the given trading pair (with a maximum of 5 price levels).

#### Response attributes

- `data` (object)
  - `data.asks` (array of object)
      The list of asks (sell orders), sorted by price in descending order.
    - `data.asks[].aid` (string)
        Crypto-asset ID code.
    - `data.asks[].anm` (string)
        Crypto-asset full name.
    - `data.asks[].s` (enum)
        The side of the price level.
        Possible enum values:

        - `SELL`
        - `BUYI`
    - `data.asks[].p` (string)
        Price in major currency units. For example, for USD, 4600 represents 4600 dollars.
    - `data.asks[].pc` (string)
        Price currency.
    - `data.asks[].pn` (string)
        Price notation.
    - `data.asks[].q` (string)
        Aggregated quantity at this price level.
    - `data.asks[].qc` (string)
        Quantity currency.
    - `data.asks[].qn` (string)
        Quantity notation.
    - `data.asks[].ve` (string)
        Venue of execution. Always equals `REVX`.
    - `data.asks[].no` (string)
        Number of orders at the price level.
    - `data.asks[].ts` (string)
        Trading system. Always equals `CLOB` (Central Limit Order Book).
    - `data.asks[].pdt` (string)
        Publication date and time, returned as [ISO-8601](https://wikipedia.org/wiki/ISO_8601) string.
  - `data.bids` (array of object)
      The list of bids (buy orders), sorted by price in descending order.
    - `data.bids[].aid` (string)
        Crypto-asset ID code.
    - `data.bids[].anm` (string)
        Crypto-asset full name.
    - `data.bids[].s` (enum)
        The side of the price level.
        Possible enum values:

        - `SELL`
        - `BUYI`
    - `data.bids[].p` (string)
        Price in major currency units. For example, for USD, 4600 represents 4600 dollars.
    - `data.bids[].pc` (string)
        Price currency.
    - `data.bids[].pn` (string)
        Price notation.
    - `data.bids[].q` (string)
        Aggregated quantity at this price level.
    - `data.bids[].qc` (string)
        Quantity currency.
    - `data.bids[].qn` (string)
        Quantity notation.
    - `data.bids[].ve` (string)
        Venue of execution. Always equals `REVX`.
    - `data.bids[].no` (string)
        Number of orders at the price level.
    - `data.bids[].ts` (string)
        Trading system. Always equals `CLOB` (Central Limit Order Book).
    - `data.bids[].pdt` (string)
        Publication date and time, returned as [ISO-8601](https://wikipedia.org/wiki/ISO_8601) string.
- `metadata` (object)
  - `metadata.timestamp` (string)
      Timestamp when the order book snapshot was generated, returned as [ISO-8601](https://wikipedia.org/wiki/ISO_8601) string.

## Error responses

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