DEX volume board by network
GET /api/dex-volume-boardA network's decentralized exchanges ranked by their share of 24h volume across the network's top pools (the 60 largest by volume, or 20-100 with `pools`): each DEX's volume share, liquidity share, turnover (volume over liquidity), pool count, buy share of trades and its largest pool, with the network's concentration (the top DEX's share and a Herfindahl index). Send GET /api/dex-volume-board with the required field network 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, poolsRead and 9 more.
Networks use on-chain ids such as eth, base, solana, arbitrum, bsc, polygon_pos. Shares are of the pools read, stated in the answer. Deterministic code over market data; refreshed 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, optimism, avax, ... |
pools | number | no | How many of the network's top pools by 24h volume to add up: 20, 40, 60, 80 or 100 (default 60). |
limit | number | no | DEXes returned, 1-50 (default 15). |
Example request
curl -i "https://agent402.tools/api/dex-volume-board?network=base"
Without payment this returns HTTP 402 Payment Required with the exact price for dex-volume-board; any x402 v2 or MPP client pays it and retries.
Example response
{
"source": "coingecko",
"fetchedAt": "2026-11-16T12:00:00.000Z",
"cached": false,
"network": "base",
"poolsRead": 60,
"scope": "the network's 60 largest pools by 24h volume",
"returned": 1,
"matched": 7,
"complete": false,
"truncated": true,
"totals": {
"volume24hUsd": 412000000,
"liquidityUsd": 286000000,
"turnover": 1.44,
"dexes": 7,
"topDexSharePct": 58.3,
"hhi": 4120
},
"dexes": [
{
"rank": 1,
"dex": "example-dex-base",
"name": "Example DEX (Base)",
"volumeSharePct": 58.3,
"liquiditySharePct": 41.2,
"turnover": 2.04,
"pools": 22,
"buyTradeSharePct": 50.6,
"topPool": {
"name": "WETH / USDC",
"address": "0x0000000000000000000000000000000000000001",
"shareOfDexVolumePct": 37.5
}
}
],
"flags": [
"concentrated"
],
"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 | base |
poolsRead | number | yes | 60 |
scope | string | yes | the network's 60 largest pools by 24h volume |
returned | number | yes | 1 |
matched | number | yes | 7 |
complete | boolean | yes | false |
truncated | boolean | yes | true |
totals | object | yes | 6 fields: volume24hUsd, liquidityUsd, turnover, dexes, topDexSharePct, hhi |
dexes | array of objects | yes | 1 item in the example |
flags | array of string | yes | 1 item in the example |
credit | string | yes | Data provided by CoinGecko (https://www.coingecko.com/en/api). |
From an MCP client
catalog.call {
"slug": "dex-volume-board",
"params": {
"network": "base"
}
}The hosted connector at https://agent402.tools/mcp needs a payment for dex-volume-board; 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
networkis 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-volume-board 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-volume-board?network=base");Related tools
DEX pool health
Measured health of one DEX pool by network and pool address: liquidity, 24h turnover (volume over liquidity), buy share.
Chain board by native asset
Blockchains ranked by their native asset, computed from three market documents: each native asset's share of the whole.
DeFi token screener
Screen the DeFi category's 250 largest tokens with computed columns: share of the category's market cap, turnover (24h.
Exchange tickers
Markets (tickers) listed on one exchange: base/target pair, last price, 24h volume, USD- and BTC-converted last price.
Solana token trading pairs
Every DEX pair trading a Solana token mint (Raydium, Orca, Meteora, Pump.fun AMM and the rest), sorted by liquidity.
Crypto categories by market cap
Coin categories (Layer 1, Meme, AI, DeFi, Stablecoins, RWA, ...) ranked by market cap, with 24h market cap change %, 24h.