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

# Pools

`GET /pools`

Returns a paginated list of pools

## Query parameters

- `page` unknown
- `page_size` unknown
- `query` unknown
- `sort_by` unknown
- `filter_by` unknown

## Response `200`

- object
  - `current_page` integer, required
  - `data` object[], 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_size` integer, required
  - `pages` integer, required
  - `total` integer, required

## Other responses

- `400`

---

[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)