---
title: "Get Current Order Book"
method: GET
path: "/v1/book/{symbol}"
tags: ["Market Data"]
---

# Get Current Order Book

`GET /v1/book/{symbol}`

## Request

- Base URL: `https://api.gemini.com`
- URL: `https://api.gemini.com/v1/book/{symbol}`
- Auth: none declared

This will return the current order book as two arrays (bids / asks).

<p class="p-4 text-sm section-icon section-info rounded-sm flex" role="alert">
  <svg
    view-box="0 0 24 24"
  >
    <path
      fill-rule="evenodd"
      clip-rule="evenodd"
      d="M11.1258 5.63252C11.5068 4.94671 12.4932 4.94671 12.8742 5.63252L19.4751 17.5143C19.8454 18.1808 19.3635 18.9999 18.601 18.9999H5.39903C4.63655 18.9999 4.15458 18.1808 4.52487 17.5143L11.1258 5.63252ZM14.6225 4.66123C13.4795 2.6038 10.5205 2.60381 9.37753 4.66124L2.77656 16.543C1.66567 18.5426 3.11158 20.9999 5.39903 20.9999H18.601C20.8884 20.9999 22.3343 18.5426 21.2234 16.543L14.6225 4.66123ZM11 7.99991V13.9999H13V7.99991H11ZM11 15.9999V17.9999H13V15.9999H11Z"
    />
  </svg>
  The quantities and prices returned are returned as strings rather than numbers. The numbers returned are exact, not rounded, and it can be dangerous to treat them as floating point numbers.
</p>

## Path parameters

- `symbol` string, required

## Query parameters

- `limit_bids` number
- `limit_asks` number

## Response `200`

The response will be two arrays. The bids and the asks are grouped by price, so each entry may represent multiple orders at that price. Each element of the array will be a JSON object.

- OrderBook
  - `bids` OrderBookEntry[]: The bid price levels currently on the book. These are offers to buy at a given price.
    - `price` string, decimal: The price
    - `amount` string, decimal: The total quantity remaining at the price
    - `timestamp` string: **DO NOT USE** - this field is included for compatibility reasons only and is just populated with a dummy value.
  - `asks` OrderBookEntry[]: The ask price levels currently on the book. These are offers to sell at a given price.
    - `price` string, decimal: The price
    - `amount` string, decimal: The total quantity remaining at the price
    - `timestamp` string: **DO NOT USE** - this field is included for compatibility reasons only and is just populated with a dummy value.

## Other responses

- `400`: Bad request - malformed request or invalid parameters
- `404`: Resource not found
- `429`: Too many requests - you have exceeded the rate limit
- `500`: Internal server error

---

[API](https://skmtc.dev/gemini/apis/rest-api.md) - [All operations](https://skmtc.dev/gemini/apis/rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gemini/apis/rest-api/revisions/24979792d748?raw)