Pools API: Liquidity Pool Data, TVL, and Statistics

The Pools API gives you access to real-time liquidity pool data across every DEX and network that DexUtils indexes. You can list pools on a network with flexible filters — by DEX, token, TVL range, and sort order — or drill down into a specific pool address to retrieve its full statistics, LP holder count, and DexUtils trust score. Both endpoints are designed for building pool explorers, screeners, and liquidity dashboards.

List Pools on a Network

GET /networks/{network}/pools

Returns a paginated list of liquidity pools on the specified network. Apply query parameters to filter and sort results to your needs.

Path Parameters

string

required

The network to query (e.g. ethereum, bsc, solana). Retrieve valid network IDs from GET /networks.

Query Parameters

string

Filter results to pools belonging to a specific DEX. Use the DEX id values returned by GET /networks/{network}/dexes (e.g. uniswap_v3, sushiswap).

string

Filter to pools that contain this token’s contract address as either token0 or token1.

number

Return only pools with TVL (in USD) greater than or equal to this value. Useful for excluding low-liquidity pools from your results.

number

Return only pools with TVL (in USD) less than or equal to this value.

string

default:"liquidity"

Field to sort results by. Accepted values:

liquidity — total value locked in USD
volume_24h — 24-hour trading volume in USD
created_at — pool creation timestamp
fee_24h — fees collected in the past 24 hours

string

default:"desc"

Sort direction. Accepted values: desc (highest first) or asc (lowest first).

integer

default:"20"

Number of pools to return per page. Maximum value is 100.

integer

default:"1"

Page number for paginated results. Combine with limit to traverse large result sets.

Code Examples

# Top 5 Uniswap V3 pools by 24h volume, minimum $1M TVL
# Replace the token below with your actual API key from the DexUtils dashboard
curl "https://api.dexutils.io/v1/networks/ethereum/pools?dex=uniswap_v3&min_liquidity=1000000&sort=volume_24h&limit=5" \
  -H "Authorization: Bearer dxu_sk_live_4f8a2bcd9e1f3a7056c8d2e94b0f1c63"

import requests

# Replace with your actual API key from the DexUtils dashboard
url = "https://api.dexutils.io/v1/networks/ethereum/pools"
headers = {"Authorization": "Bearer dxu_sk_live_4f8a2bcd9e1f3a7056c8d2e94b0f1c63"}
params = {
    "dex": "uniswap_v3",
    "min_liquidity": 1_000_000,
    "sort": "volume_24h",
    "limit": 5,
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

for pool in data["pools"]:
    print(f"{pool['name']} — TVL: ${pool['liquidity_usd']}")

print(f"Total matching pools: {data['total']}")

// Replace with your actual API key from the DexUtils dashboard
const params = new URLSearchParams({
  dex: "uniswap_v3",
  min_liquidity: 1_000_000,
  sort: "volume_24h",
  limit: 5,
});

const response = await fetch(
  `https://api.dexutils.io/v1/networks/ethereum/pools?${params}`,
  {
    headers: {
      Authorization: "Bearer dxu_sk_live_4f8a2bcd9e1f3a7056c8d2e94b0f1c63",
    },
  }
);

const data = await response.json();

data.pools.forEach((pool) => {
  console.log(`${pool.name} — TVL: $${pool.liquidity_usd}`);
});

console.log(`Total matching pools: ${data.total}`);

Response Fields

array

required

Array of pool objects matching your filter criteria.

Show Pool object

string

required

Pool contract address on the network.

string

required

Human-readable pool name, typically formatted as TOKEN0 / TOKEN1 FEE% (e.g. USDC / WETH 0.05%).

string

required

Network ID where this pool is deployed.

string

required

DEX ID this pool belongs to (e.g. uniswap_v3).

object

required

The first token in the pair.

Show token0 object

string

required

Contract address of token0.

string

required

Ticker symbol of token0.

object

required

The second token in the pair.

Show token1 object

string

required

Contract address of token1.

string

required

Ticker symbol of token1.

integer

required

Pool fee tier in basis points (e.g. 500 = 0.05%, 3000 = 0.3%). For non-tiered AMMs this reflects the static swap fee.

string

required

Current total value locked (TVL) in USD.

string

required

Total USD trading volume in the past 24 hours.

string

required

Total fees collected by liquidity providers in the past 24 hours, in USD.

string

required

ISO 8601 timestamp of when the pool contract was deployed on-chain.

integer

required

Total number of pools matching your filter criteria, across all pages.

integer

required

The current page number.

integer

required

The number of results per page used for this response.

Example Response

{
  "pools": [
    {
      "address": "0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640",
      "name": "USDC / WETH 0.05%",
      "network": "ethereum",
      "dex": "uniswap_v3",
      "token0": {
        "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "symbol": "USDC"
      },
      "token1": {
        "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "symbol": "WETH"
      },
      "fee_tier": 500,
      "liquidity_usd": "182341204.12",
      "volume_24h_usd": "441238910.55",
      "fee_24h_usd": "220619.45",
      "created_at": "2021-05-05T21:30:02Z"
    }
  ],
  "total": 14823,
  "page": 1,
  "limit": 20
}

Get Pool Details

GET /networks/{network}/pools/{address}

Returns the full statistics for a single liquidity pool, including additional fields for locked liquidity, LP holder count, 24-hour price change, and the DexUtils trust score.

Path Parameters

string

required

The network the pool is deployed on (e.g. ethereum).

string

required

The pool’s contract address. EVM addresses are case-insensitive; the API normalises them automatically.

Code Examples

# Replace the token below with your actual API key from the DexUtils dashboard
curl "https://api.dexutils.io/v1/networks/ethereum/pools/0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640" \
  -H "Authorization: Bearer dxu_sk_live_4f8a2bcd9e1f3a7056c8d2e94b0f1c63"

import requests

# Replace with your actual API key from the DexUtils dashboard
network = "ethereum"
pool_address = "0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640"
url = f"https://api.dexutils.io/v1/networks/{network}/pools/{pool_address}"
headers = {"Authorization": "Bearer dxu_sk_live_4f8a2bcd9e1f3a7056c8d2e94b0f1c63"}

response = requests.get(url, headers=headers)
pool = response.json()

print(f"Pool: {pool['name']}")
print(f"TVL: ${pool['liquidity_usd']}")
print(f"Locked liquidity: {pool['locked_liquidity_pct']}%")
print(f"Trust score: {pool['dext_score']}")

// Replace with your actual API key from the DexUtils dashboard
const network = "ethereum";
const poolAddress = "0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640";

const response = await fetch(
  `https://api.dexutils.io/v1/networks/${network}/pools/${poolAddress}`,
  {
    headers: {
      Authorization: "Bearer dxu_sk_live_4f8a2bcd9e1f3a7056c8d2e94b0f1c63",
    },
  }
);

const pool = await response.json();

console.log(`Pool: ${pool.name}`);
console.log(`TVL: $${pool.liquidity_usd}`);
console.log(`Locked liquidity: ${pool.locked_liquidity_pct}%`);
console.log(`Trust score: ${pool.dext_score}`);

Additional Response Fields

This endpoint returns all fields from the list endpoint plus the following:

number

required

Percentage of pool liquidity that is locked via a time-lock or burn mechanism. Higher values indicate reduced rug-pull risk.

integer

required

Number of unique addresses holding LP tokens for this pool.

number

required

Percentage change in the pool’s price ratio over the past 24 hours, expressed as token1 per token0.

integer

required

DexUtils trust score from 0 to 100. Factors include locked liquidity percentage, LP distribution, token verification status, and contract audit results. Scores above 70 are generally considered low risk.

Example Response

{
  "address": "0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640",
  "name": "USDC / WETH 0.05%",
  "network": "ethereum",
  "dex": "uniswap_v3",
  "token0": {
    "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "symbol": "USDC"
  },
  "token1": {
    "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
    "symbol": "WETH"
  },
  "fee_tier": 500,
  "liquidity_usd": "182341204.12",
  "volume_24h_usd": "441238910.55",
  "fee_24h_usd": "220619.45",
  "created_at": "2021-05-05T21:30:02Z",
  "locked_liquidity_pct": 84.3,
  "lp_holder_count": 3241,
  "price_change_24h_pct": 1.87,
  "dext_score": 91
}

A high dext_score reduces but does not eliminate risk. Always perform your own due diligence before making investment decisions based on on-chain data.

Get Started

Endpoints

Guides

Pools API: Liquidity Pool Data, TVL, and Statistics

List Pools on a Network

Path Parameters

Query Parameters

Code Examples

Response Fields

Example Response

Get Pool Details

Path Parameters

Code Examples

Additional Response Fields

Example Response

​List Pools on a Network

​Path Parameters

​Query Parameters

​Code Examples

​Response Fields

​Example Response

​Get Pool Details

​Path Parameters

​Code Examples

​Additional Response Fields

​Example Response

List Pools on a Network

Path Parameters

Query Parameters

Code Examples

Response Fields

Example Response

Get Pool Details

Path Parameters

Code Examples

Additional Response Fields

Example Response