DEX pool health
GET /api/dex-pool-healthMeasured 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).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
network | string | yes | On-chain network id: eth, base, solana, arbitrum, bsc, polygon_pos, ... |
pool | string | yes | Pool 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)."
}| Field | Type | Always present | In the example |
|---|---|---|---|
source | string | yes | coingecko |
fetchedAt | string | yes | 2026-11-16T12:00:00.000Z |
cached | boolean | yes | false |
network | string | yes | eth |
pool | string | yes | 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640 |
name | string | yes | WETH / USDC 0.05% |
dex | string | yes | uniswap_v3 |
ageDays | number | yes | 1783 |
liquidityUsd | number | yes | 76692781 |
volume24hUsd | number | yes | 104131045 |
turnover24h | number | yes | 1.36 |
lockedLiquidityPct | number | yes | 0 |
activity24h | object | yes | 3 fields: trades, buyTradeSharePct, buyerSharePct |
tradesRead | boolean | yes | true |
recentTrades | object | yes | 11 fields: count, windowMinutes, medianUsd, p90Usd, largestUsd and 6 more |
priceImpactEstimate | object | yes | 3 fields: per1kUsdPct, per10kUsdPct, method |
flags | array | yes | 0 items in the example |
credit | string | yes | Data 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
networkandpoolare required. An input the tool rejects returns an HTTP 4xx whose body carrieserror,tool,expected,requiredandexample, so the caller can correct it.- A paid call that ends in any status of 400 or above is not charged over x402, MPP or a prepaid credits key: settlement runs after the tool and only on a successful response. The exception is a Tempo push credential, a transfer the buyer sent before the call: it settles before the tool runs, so if the tool then fails the payment is recorded as a refund owed to the paying wallet.
- Wallet-only: this tool reaches the network or stored state, so it has no proof-of-work tier. A prepaid card-credits key issued earlier (
Authorization: Bearer a402_...) also pays it. - A
POSTwith a JSON body to /api/dex-pool-health is served as this GET, with the body as the input. - An
Idempotency-Keyheader makes a retried paid call replay the first 200 instead of charging again (an answer larger than 1 MB is not replayed).
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
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
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
Read on-chain state of a Uniswap V3 pool: token0/token1 addresses + decimals, fee tier, current sqrtPriceX96, tick.
Crypto categories by market cap
Coin categories (Layer 1, Meme, AI, DeFi, Stablecoins, RWA, ...) ranked by market cap, with 24h market cap change %, 24h.
Crypto news headlines
Latest crypto headlines aggregated from the public RSS/Atom feeds of 8 major outlets (coindesk, cointelegraph, decrypt.
DeFi token screener
Screen the DeFi category's 250 largest tokens with computed columns: share of the category's market cap, turnover (24h.