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

# Returns list of pools which correspond to the given params

`GET /v1/yield/pools`

## Query parameters

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

## Response `200`

List of corresponding pools

- ApiYieldSearchResponse[]
  - `total_count` integer, required
  - `pools` ApiYieldPool[], required
    - `address` string, required
    - `protocol` 'stonfi' | 'dedust' | 'stonfi_v2' | 'coffee' | 'tonraffles' | 'tonco' | 'tonco_v2' | 'colossus' | 'bidask' | 'tonstakers' | 'bemo' | 'bemo_v2' | 'hipo' | 'torch_finance' | 'stakee' | 'kton' | 'evaa' | 'coffin' | 'moon' | 'storm_trade' | 'farmix_lending' | 'dao_lama_vault', required
    - `is_trusted` boolean, required
    - `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
    - `pool_statistics` 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
    - `pool` ApiYieldBriefPoolDex
      - `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

## 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/8f32977bfb50/schema)