Skip to content

DEX pool health

$0.005 per callUSDC via x402GET /api/dex-pool-health

Measured health of one DEX pool by network and pool address: liquidity, 24h turnover (volume over liquidity), buy share of trades and of traders, the size distribution of its latest trades (median, 90th percentile, largest, largest as a share of liquidity), how concentrated those trades are among wallets (top wallet's share, share from wallets trading three times or more), buy share of recent volume, a constant-product price-impact estimate for $1,000 and $10,000, the pool's age and locked-liquidity share. Send GET /api/dex-pool-health with the required fields network and pool and pay $0.005 per call over x402 or MPP (there is no free tier). It returns a JSON object with source, fetchedAt, cached, network, pool and 13 more.

`tradesRead` is false, and the recent-trades block null, when the pool's trade list could not be read. Flags name measured conditions with fixed thresholds (thin liquidity, new pool, high churn, one-sided flow, wallet concentration, repeat-wallet flow, no recent trades); measurements only, with no score and no verdict. Networks use on-chain ids such as eth, base, solana. Deterministic code over market data; recent trades refreshed every 5 minutes, the pool's liquidity, 24h volume and 24h counts every 30 minutes. Data provided by CoinGecko (https://www.coingecko.com/en/api).

Category: Crypto & onchain dataTags: crypto dex pool liquidity pool-health price-impact repeat-wallets tradesAlso found as: pool-liquidity dex-pool-liquidity pool-health

Try in playground →

Parameters

NameTypeRequiredDescription
networkstringyesOn-chain network id: eth, base, solana, arbitrum, bsc, polygon_pos, ...
poolstringyesPool address on that network.

Example request

curl -i "https://agent402.tools/api/dex-pool-health?network=eth&pool=0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640"

Without payment this returns HTTP 402 Payment Required with the exact price for dex-pool-health; any x402 v2 or MPP client pays it and retries.

Example response

{
  "source": "coingecko",
  "fetchedAt": "2026-11-16T12:00:00.000Z",
  "cached": false,
  "network": "eth",
  "pool": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  "name": "WETH / USDC 0.05%",
  "dex": "uniswap_v3",
  "ageDays": 1783,
  "liquidityUsd": 76692781,
  "volume24hUsd": 104131045,
  "turnover24h": 1.36,
  "lockedLiquidityPct": 0,
  "activity24h": {
    "trades": 6098,
    "buyTradeSharePct": 50.18,
    "buyerSharePct": 48.08
  },
  "tradesRead": true,
  "recentTrades": {
    "count": 300,
    "windowMinutes": 96,
    "medianUsd": 1840.5,
    "p90Usd": 41200,
    "largestUsd": 512000,
    "largestShareOfLiquidityPct": 0.67,
    "buyVolumeSharePct": 47.3,
    "uniqueWallets": 168,
    "topWalletTradeSharePct": 6.33,
    "repeatWalletTradeSharePct": 38.67,
    "anomalous": 0
  },
  "priceImpactEstimate": {
    "per1kUsdPct": 0.0026,
    "per10kUsdPct": 0.0261,
    "method": "constant-product approximation from total liquidity; a concentrated-liquidity pool trades tighter near the current price"
  },
  "flags": [],
  "credit": "Data provided by CoinGecko (https://www.coingecko.com/en/api)."
}
FieldTypeAlways presentIn the example
sourcestringyescoingecko
fetchedAtstringyes2026-11-16T12:00:00.000Z
cachedbooleanyesfalse
networkstringyeseth
poolstringyes0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640
namestringyesWETH / USDC 0.05%
dexstringyesuniswap_v3
ageDaysnumberyes1783
liquidityUsdnumberyes76692781
volume24hUsdnumberyes104131045
turnover24hnumberyes1.36
lockedLiquidityPctnumberyes0
activity24hobjectyes3 fields: trades, buyTradeSharePct, buyerSharePct
tradesReadbooleanyestrue
recentTradesobjectyes11 fields: count, windowMinutes, medianUsd, p90Usd, largestUsd and 6 more
priceImpactEstimateobjectyes3 fields: per1kUsdPct, per10kUsdPct, method
flagsarrayyes0 items in the example
creditstringyesData provided by CoinGecko (https://www.coingecko.com/en/api).

From an MCP client

catalog.call {
  "slug": "dex-pool-health",
  "params": {
    "network": "eth",
    "pool": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640"
  }
}

The hosted connector at https://agent402.tools/mcp needs a payment for dex-pool-health; the stdio package pays it from a wallet or from an AGENT402_CREDITS_KEY issued earlier. Local install: npx -y agent402-mcp@0.13.32.

Errors and behavior

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
client.setSpendControls?.({ maxAmountPerPayment: "$0.005" }); // refuse any quote above this tool's price
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/dex-pool-health?network=eth&pool=0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640");

Related tools

DEX volume board by network

$0.005GET /api/dex-volume-board

A network's decentralized exchanges ranked by their share of 24h volume across the network's top pools (the 60 largest.

Resolve Uniswap V3 pool address

$0.001POST /api/dex-pair

Look up the Uniswap V3 pool address for a token pair + fee tier on Ethereum, Base, Polygon, Arbitrum, or Optimism.

Read Uniswap V3 pool state

$0.002POST /api/dex-pool

Read on-chain state of a Uniswap V3 pool: token0/token1 addresses + decimals, fee tier, current sqrtPriceX96, tick.

Crypto categories by market cap

$0.005GET /api/coin-categories

Coin categories (Layer 1, Meme, AI, DeFi, Stablecoins, RWA, ...) ranked by market cap, with 24h market cap change %, 24h.

Crypto news headlines

$0.002POST /api/crypto-news

Latest crypto headlines aggregated from the public RSS/Atom feeds of 8 major outlets (coindesk, cointelegraph, decrypt.

DeFi token screener

$0.005GET /api/defi-screener

Screen the DeFi category's 250 largest tokens with computed columns: share of the category's market cap, turnover (24h.