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

# Discover pools

`GET /pools/discover`

Retrieve a list of pools with filtering, sorting, and pagination

## Query parameters

- `chain` string
- `sortBy` 'mcap' | 'created_at' | 'vol_24h' | 'tvl' | 'fee_tvl_ratio' | 'volatility'
- `sortOrder` 'asc' | 'desc' | 'default'
- `page` integer
- `pageSize` integer
- `feeTVLInterval` '5m' | '1h' | '6h' | '24h'
- `quote_token` string
- `min_market_cap` number
- `max_market_cap` number
- `min_bin_step` number
- `max_bin_step` number
- `min_organic_score` number
- `max_organic_score` number
- `min_base_fee` number
- `max_base_fee` number
- `min_age_hr` number
- `max_age_hr` number
- `min_liquidity` number
- `max_liquidity` number
- `min_24h_fees` number
- `max_24h_fees` number
- `min_24h_vol` number
- `max_24h_vol` number
- `min_1h_vol` number
- `max_1h_vol` number
- `type` string
- `search` string

## Response `200`

Successfully retrieved pools

- object
  - `status` string
  - `data` object[]
    - `pool` string — Pool address
    - `tvl` number — Total value locked
    - `fee` number — Pool fee rate
    - `protocol` string — Protocol name
    - `chain` string
    - `token0` string — Token X mint address
    - `token1` string — Token Y mint address
    - `vol_5m` number — Volume in last 5 minutes
    - `vol_1h` number — Volume in last 1 hour
    - `vol_6h` number — Volume in last 6 hours
    - `vol_24h` number — Volume in last 24 hours
    - `base_price` number — Base token price in USD
    - `quote_price` number — Quote token price in USD
    - `mcap` number — Market cap
    - `usd_price` number — Token USD price
    - `fdv` number — Fully diluted valuation
    - `organic_score` number — Organic trading score
    - `top_holder` number — Top holder percentage
    - `mint_freeze` boolean — Whether mint/freeze authority is enabled
    - `price_5m_change` number — Price change in last 5 minutes
    - `price_1h_change` number — Price change in last 1 hour
    - `price_6h_change` number — Price change in last 6 hours
    - `price_24h_change` number — Price change in last 24 hours
    - `bin_step` number — Bin step size
    - `liquidity_token0` number — Liquidity of token X
    - `liquidity_token1` number — Liquidity of token Y
    - `created_at` string, date-time — Pool creation time
    - `updated_at` string, date-time
    - `first_pool_created_at` string, date-time
    - `token0_symbol` string, nullable
    - `token0_name` string, nullable
    - `token0_decimals` number, nullable
    - `token1_symbol` string, nullable
    - `token1_name` string, nullable
    - `token1_decimals` number, nullable
    - `token0_stats` object, nullable — Token X trading stats from Jupiter
      - `volume` object
        - `stats1h` object
          - `volume` number
          - `volume_change` number
        - `stats6h` object
          - `volume` number
          - `volume_change` number
        - `stats24h` object
          - `volume` number
          - `volume_change` number
      - `holders` number
    - `token1_stats` object, nullable — Token Y trading stats from Jupiter
  - `pagination` object
    - `currentPage` integer
    - `pageSize` integer
    - `totalCount` integer
    - `totalPages` integer
    - `hasNextPage` boolean
    - `hasPreviousPage` boolean

## Other responses

- `500` — Internal server error

## Changes

- **2026-03-13** `23fdd2328560` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/lpagent/apis/lp-agent-open-api/changes/pools/discover/get.md)

---

[API](https://skmtc.dev/lpagent/apis/lp-agent-open-api.md) · [All operations](https://skmtc.dev/lpagent/apis/lp-agent-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lpagent/lp-agent-open-api/revisions/f90fd69d221b/schema)