---
title: "Pool Search"
method: GET
path: "/pools/search"
tags: ["Pools"]
---

# Pool Search

`GET /pools/search`

## Query parameters

- `page` integer, required
- `size` integer, required
- `filter` string, nullable
- `sort_key` 'tvl' | 'volume' | 'fee_tvl_ratio' | 'l_m'
- `order_by` 'asc' | 'desc'
- `pools_to_top` string[]
- `unknown` boolean, nullable
- `pool_type` 'dynamic' | 'multitoken' | 'lst' | 'farms'
- `is_monitoring` boolean, nullable
- `hide_low_tvl` number, double, nullable
- `hide_low_apr` boolean, nullable
- `include_token_mints` string[], nullable
- `include_pool_token_pairs` string[], nullable
- `launchpad` string[], nullable

## Response `200`

- PaginatedPoolResponse
  - `data` PoolResponse, required
    - `address` string, required — Address of the liquidity pair
    - `apr` number, double, required — 24 hour APR
    - `apy` number, double, required — 24 hour APY
    - `created_at` integer, required — Pool created at timestamp
    - `cumulative_metrics` CumulativeMetrics, required
      - `fees` number, double, required
      - `volume` number, double, required
    - `current_price` number, double, required — Price of the liquidity pair
    - `dynamic_fee_pct` number, double, required — Dynamic fee rate. Which is equal to base fee + variable fee.
    - `farm_apr` number, double, required — Farm reward apr
    - `farm_apy` number, double, required — Farm reward apy
    - `fee_tvl_ratio` TimeWindowData, required
      - `12h` number, double, required
      - `1h` number, double, required
      - `24h` number, double, required
      - `2h` number, double, required
      - `30m` number, double, required
      - `4h` number, double, required
    - `fees` TimeWindowData, required
      - `12h` number, double, required
      - `1h` number, double, required
      - `24h` number, double, required
      - `2h` number, double, required
      - `30m` number, double, required
      - `4h` number, double, required
    - `has_farm` boolean, required — Whether the pool has a farm or not
    - `is_blacklisted` boolean, required — Flag to indicate whether the pair is blacklisted
    - `launchpad` unknown
    - `name` string, required — Name of the liquidity pair
    - `pool_config` PoolConfig, required
      - `base_fee_pct` number, double, required — Base fee rate
      - `bin_step` integer, required — Bin step of the pool
      - `collect_fee_mode` integer, required — Fee collection mode
      - `max_fee_pct` number, double, required — Maximum fee rate
      - `protocol_fee_pct` number, double, required — Protocol fee rate. A cut from trade fee.
    - `protocol_fees` TimeWindowData, required
      - `12h` number, double, required
      - `1h` number, double, required
      - `24h` number, double, required
      - `2h` number, double, required
      - `30m` number, double, required
      - `4h` number, double, required
    - `reserve_x` string, required — Address of token X reserve of the liquidity pair
    - `reserve_y` string, required — Address of token Y reserve of the liquidity pair
    - `reward_mint_x` string, required — Address of the farming reward X of the liquidity pair
    - `reward_mint_y` string, required — Address of the farming reward Y of the liquidity pair
    - `tags` string[], required — Tags of the pair
    - `token_x` TokenMetrics, required
      - `address` string, required
      - `decimals` integer, required
      - `freeze_authority_disabled` boolean, required
      - `holders` integer, required
      - `is_verified` boolean, required
      - `market_cap` number, double, required
      - `name` string, required
      - `price` number, double, required
      - `symbol` string, required
      - `total_supply` number, double, required
    - `token_x_amount` number, double, required — Token X amount the liquidity pair hold
    - `token_y` TokenMetrics, required
      - `address` string, required
      - `decimals` integer, required
      - `freeze_authority_disabled` boolean, required
      - `holders` integer, required
      - `is_verified` boolean, required
      - `market_cap` number, double, required
      - `name` string, required
      - `price` number, double, required
      - `symbol` string, required
      - `total_supply` number, double, required
    - `token_y_amount` number, double, required — Token Y amount the liquidity pair hold
    - `tvl` number, double, required — Total liquidity the liquidity pair holding. Also known as Total Value Locked
    - `volume` TimeWindowData, required
      - `12h` number, double, required
      - `1h` number, double, required
      - `24h` number, double, required
      - `2h` number, double, required
      - `30m` number, double, required
      - `4h` number, double, required
  - `page` integer, required
  - `total_count` integer, required

---

[API](https://skmtc.net/meteora/apis/dynamic-amm-keeper.md) · [All operations](https://skmtc.net/meteora/apis/dynamic-amm-keeper/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meteora/dynamic-amm-keeper/versions/453231c15a14/schema)