---
title: "OrderBooks queries order books."
method: GET
path: "/coreum/dex/v1/order-books"
tags: ["Query"]
---

# OrderBooks queries order books.

`GET /coreum/dex/v1/order-books`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/coreumfoundation/apis/title-goes-here/docs/coreum/dex/v1/order-books/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `pagination.key` string, byte
- `pagination.offset` string, uint64
- `pagination.limit` string, uint64
- `pagination.count_total` boolean
- `pagination.reverse` boolean

## Response `200`

A successful response.

- CoreumDexV1QueryOrderBooksResponse: QueryOrderBooksResponse defines the response type for the `OrderBooks` query.
  - `order_books` CoreumDexV1OrderBookData[]
    - `base_denom` string: base_denom is base order book denom.
    - `quote_denom` string
  - `pagination` CosmosBaseQueryV1beta1PageResponse: PageResponse is to be embedded in gRPC response messages where the corresponding request message has used PageRequest. message SomeResponse { repeated Bar results = 1; PageResponse page = 2; }
    - `next_key` string, byte: next_key is the key to be passed to PageRequest.key to query the next page most efficiently. It will be empty if there are no more results.
    - `total` string, uint64

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-07-17** `2a2e5bc4593a`: 1 info
  - api operation id `GithubComCoreumFoundationCoreumV5XDexTypesOrderBooks` removed and replaced with `GithubComCoreumFoundationCoreumV6XDexTypesOrderBooks`
- **2024-10-02** `fe7f82691f29`: 1 info
  - api operation id `GithubComCoreumFoundationCoreumV4XDexTypesOrderBooks` removed and replaced with `GithubComCoreumFoundationCoreumV5XDexTypesOrderBooks`
- **2024-09-24** `e2df762a03f6`: 1 info
  - endpoint added
- **2023-09-11** `aaa274f20b71`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/coreumfoundation/apis/title-goes-here/changes/coreum/dex/v1/order-books/get.md)

---

[API](https://skmtc.dev/coreumfoundation/apis/title-goes-here.md) - [All operations](https://skmtc.dev/coreumfoundation/apis/title-goes-here/llms.txt) - [OpenAPI document](https://skmtc.dev/coreumfoundation/apis/title-goes-here/revisions/2a2e5bc4593a?raw)