---
title: "Pools returns all liquidity pools."
method: GET
path: "/crescent/liquidity/v1beta1/pools"
tags: ["Query"]
---

# Pools returns all liquidity pools.

`GET /crescent/liquidity/v1beta1/pools`

## 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/pools/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

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

## Response `200`

A successful response.

- object: QueryPoolsResponse is response type for the Query/Pools RPC method.
  - `pools` object[]
    - `type` 'POOL_TYPE_UNSPECIFIED' | 'POOL_TYPE_BASIC' | 'POOL_TYPE_RANGED': PoolType enumerates pool types. - POOL_TYPE_UNSPECIFIED: POOL_TYPE_UNSPECIFIED specifies unknown pool type - POOL_TYPE_BASIC: POOL_TYPE_BASIC specifies the basic pool type - POOL_TYPE_RANGED: POOL_TYPE_RANGED specifies the ranged pool type
    - `id` string, uint64
    - `pair_id` string, uint64
    - `creator` string
    - `reserve_address` string
    - `pool_coin_denom` string
    - `pool_coin_supply` string
    - `min_price` string
    - `max_price` string
    - `price` string
    - `balances` object
      - `base_coin` object: Coin defines a token with a denomination and an amount. NOTE: The amount field is an Int which implements the custom method signatures required by gogoproto.
        - `denom` string
        - `amount` string
      - `quote_coin` object: Coin defines a token with a denomination and an amount. NOTE: The amount field is an Int which implements the custom method signatures required by gogoproto.
        - `denom` string
        - `amount` string
    - `last_deposit_request_id` string, uint64
    - `last_withdraw_request_id` string, uint64
    - `disabled` boolean
  - `pagination` object: 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
    - `total` string, uint64

## Other responses

- `default`: An unexpected error response

## Changes

- **2022-03-17** `050a36bde231`: 1 info
  - endpoint added
- **2022-01-24** `63a98ab49fe1`: 1 breaking
  - api path removed without deprecation
- **2022-01-24** `9df0a4d8de8e`: 1 info
  - endpoint added
- **2022-01-24** `c74d7f3d449c`: 1 breaking
  - api path removed without deprecation
- **2022-01-20** `b43e8b77c563`: 2 warning, 2 info
  - deleted the `query` request parameter `disabled`
  - deleted the `query` request parameter `pair_id`
  - added the new optional `query` request parameter `x_denom`
  - added the new optional `query` request parameter `y_denom`

[Operation history](https://skmtc.dev/crescent-network/apis/crescent-rest-and-grpc-gateway-docs/changes/crescent/liquidity/v1beta1/pools/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)