---
title: "Get Clmm Pools"
method: GET
path: "/gateway/clmm/pools"
tags: ["Gateway CLMM"]
---

# Get Clmm Pools

`GET /gateway/clmm/pools`

Get list of available CLMM pools for a connector.

Currently supports: meteora

Args:
    connector: CLMM connector (e.g., 'meteora')
    page: Page number (default: 0)
    limit: Results per page (default: 50, max: 100)
    search_term: Search term to filter pools (optional)
    sort_key: Sort by field (volume, tvl, feetvlratio, etc.)
    order_by: Sort order (asc, desc)
    include_unknown: Include pools with unverified tokens

Example:
    GET /gateway/clmm/pools?connector=meteora&search_term=SOL&limit=20

Returns:
    List of available pools with trading pairs, addresses, liquidity, volume, APR, etc.

## Query parameters

- `connector` string, required
- `page` integer — Page number
- `limit` integer — Results per page (max 100)
- `search_term` string, nullable — Search term to filter pools
- `sort_key` string, nullable — Sort key (volume, tvl, etc.)
- `order_by` string, nullable — Sort order (asc, desc)
- `include_unknown` boolean — Include pools with unverified tokens

## Response `200`

Successful Response

- CLMMPoolListResponse — Response with list of available CLMM pools
  - `pools` CLMMPoolListItem[], required — List of available pools
    - `address` string, required — Pool address
    - `name` string, required — Pool name (e.g., 'SOL-USDC')
    - `trading_pair` string, required — Trading pair derived from tokens
    - `mint_x` string, required — Base token mint address
    - `mint_y` string, required — Quote token mint address
    - `bin_step` integer, required — Bin step size
    - `current_price` string, required — Current pool price
    - `liquidity` string, required — Total liquidity in pool
    - `reserve_x` string, required — Base token reserves
    - `reserve_y` string, required — Quote token reserves
    - `reserve_x_amount` string, nullable — Base token reserves as decimal amount
    - `reserve_y_amount` string, nullable — Quote token reserves as decimal amount
    - `base_fee_percentage` string, nullable — Base fee percentage
    - `max_fee_percentage` string, nullable — Maximum fee percentage
    - `protocol_fee_percentage` string, nullable — Protocol fee percentage
    - `apr` string, nullable — Annual percentage rate
    - `apy` string, nullable — Annual percentage yield
    - `farm_apr` string, nullable — Farming annual percentage rate
    - `farm_apy` string, nullable — Farming annual percentage yield
    - `volume_24h` string, nullable — 24h trading volume
    - `fees_24h` string, nullable — 24h fees collected
    - `today_fees` string, nullable — Today's fees collected
    - `cumulative_trade_volume` string, nullable — Cumulative trade volume
    - `cumulative_fee_volume` string, nullable — Cumulative fee volume
    - `volume` TimeBasedMetrics — Time-based metrics (volume, fees, fee-to-TVL ratio) for different time periods
      - `min_30` string, nullable — 30 minute metric
      - `hour_1` string, nullable — 1 hour metric
      - `hour_2` string, nullable — 2 hour metric
      - `hour_4` string, nullable — 4 hour metric
      - `hour_12` string, nullable — 12 hour metric
      - `hour_24` string, nullable — 24 hour metric
    - `fees` TimeBasedMetrics — Time-based metrics (volume, fees, fee-to-TVL ratio) for different time periods
      - `min_30` string, nullable — 30 minute metric
      - `hour_1` string, nullable — 1 hour metric
      - `hour_2` string, nullable — 2 hour metric
      - `hour_4` string, nullable — 4 hour metric
      - `hour_12` string, nullable — 12 hour metric
      - `hour_24` string, nullable — 24 hour metric
    - `fee_tvl_ratio` TimeBasedMetrics — Time-based metrics (volume, fees, fee-to-TVL ratio) for different time periods
      - `min_30` string, nullable — 30 minute metric
      - `hour_1` string, nullable — 1 hour metric
      - `hour_2` string, nullable — 2 hour metric
      - `hour_4` string, nullable — 4 hour metric
      - `hour_12` string, nullable — 12 hour metric
      - `hour_24` string, nullable — 24 hour metric
    - `reward_mint_x` string, nullable — Base token reward mint address
    - `reward_mint_y` string, nullable — Quote token reward mint address
    - `tags` string[], nullable — Pool tags
    - `is_verified` boolean — Whether tokens are verified
    - `is_blacklisted` boolean, nullable — Whether pool is blacklisted
    - `hide` boolean, nullable — Whether pool should be hidden
    - `launchpad` string, nullable — Associated launchpad
  - `total` integer, required — Total number of pools
  - `page` integer, required — Current page number
  - `limit` integer, required — Results per page

## Other responses

- `422` — Validation Error

---

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