---
title: "Returns list of pools which correspond to the given params"
method: GET
path: "/v1/pools"
tags: ["Entity"]
---

# Returns list of pools which correspond to the given params

`GET /v1/pools`

## Query parameters

- `blockchains` ApiSupportedBlockchain[]
- `dexes` ApiSupportedYields[]
- `trusted` boolean
- `with_active_boosts` boolean
- `recently_created` boolean
- `with_liquidity_from` string
- `search_text` string
- `order` 'tvl' | 'volume' | 'apr'
- `descending_order` boolean
- `in_groups` boolean
- `size` integer
- `page` integer

## Response `200`

List of corresponding pools

- ApiPoolsSearchResponse[]
  - `total_count` integer, required
  - `pools` ApiPoolInfo[], required
    - `pool` ApiPool, required
      - `dex` string, required
      - `address` string, required
      - `type` 'public' | 'private' | 'slumbering' | 'invalid', required
      - `amm_type` 'constant_product' | 'cubic_stable' | 'curve_fi_stable' | 'concentrated_v3' | 'tonstakers' | 'weighted_constant_product' | 'weighted_stable' | 'bidask' | 'moon_dlmm' | 'bidask_damm' | 'dedust_v2', required
      - `amm_settings` ApiJson
      - `tokens` ApiToken[], required
        - `address` ApiTokenAddress, required
          - `blockchain` string, required
          - `address` string, required
        - `metadata` ApiTokenMetadata, required
          - `name` string, required
          - `symbol` string, required
          - `decimals` integer, required
          - `image_url` string
          - `listed` boolean, required
          - `verification` 'whitelisted' | 'blacklisted' | 'community' | 'unknown', required
      - `reserves` number[], required
      - `restrictions` ApiTokenRestrictions[]
        - `min_swap_amount` number, double
        - `max_swap_amount` number, double
      - `fees` ApiPoolFees, required
        - `average_gas` number, double, required
        - `divider` integer
        - `input` integer
        - `output` integer
        - `first_token` integer
        - `second_token` integer
      - `unavailable_until` integer — UTC unix timestamp in seconds
    - `info` ApiPoolStatistics, required
      - `address` string, required
      - `tvl_usd` number, double, required
      - `volume_usd` number, double, required
      - `fee_usd` number, double, required
      - `apr` number, double, required
      - `lp_apr` number, double, required
      - `boost_apr` number, double, required
      - `locked_asset_amount` string

## Other responses

- `default` — Some error during request processing

---

[API](https://skmtc.net/swap/apis/swap-coffee-api.md) · [All operations](https://skmtc.net/swap/apis/swap-coffee-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/swap/swap-coffee-api/revisions/fd1067547679/schema)