---
title: "GET /crescent/liquidity/v1beta1/order_books"
method: GET
path: "/crescent/liquidity/v1beta1/order_books"
tags: ["Query"]
---

# GET /crescent/liquidity/v1beta1/order_books

`GET /crescent/liquidity/v1beta1/order_books`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs/docs/crescent/liquidity/v1beta1/order_books/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `pair_ids` string[]
- `price_unit_powers` integer[]
- `num_ticks` integer

## Response `200`

A successful response.

- object: QueryOrderBooksResponse is response type for Query/OrderBooks RPC method.
  - `pairs` object[]
    - `pair_id` string, uint64
    - `base_price` string
    - `order_books` object[]
      - `price_unit` string
      - `sells` object[]
        - `price` string
        - `user_order_amount` string
        - `pool_order_amount` string
      - `buys` object[]
        - `price` string
        - `user_order_amount` string
        - `pool_order_amount` string

## Other responses

- `default`: An unexpected error response

## Changes

- **2022-07-27** `3c7605350664`: 1 info
  - added the new optional `query` request parameter `price_unit_powers`
- **2022-07-18** `03268516d7aa`: 1 warning
  - deleted the `query` request parameter `tick_precisions`
- **2022-06-30** `265965ba45c0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs/changes/crescent/liquidity/v1beta1/order_books/get.md)

---

[API](https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs.md) - [All operations](https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs/revisions/ddf5133cea9d?raw)