Skip to content

DEX volume board by network

$0.005 per callUSDC via x402GET /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 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).

Category: Crypto & onchain dataTags: crypto dex volume market-share liquidity network ranking defiAlso found as: dex-volume dex-market-share

Try in playground →

Parameters

NameTypeRequiredDescription
networkstringyesOn-chain network id: eth, base, solana, arbitrum, bsc, polygon_pos, optimism, avax, ...
poolsnumbernoHow many of the network's top pools by 24h volume to add up: 20, 40, 60, 80 or 100 (default 60).
limitnumbernoDEXes 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)."
}
FieldTypeAlways presentIn the example
sourcestringyescoingecko
fetchedAtstringyes2026-11-16T12:00:00.000Z
cachedbooleanyesfalse
networkstringyesbase
poolsReadnumberyes60
scopestringyesthe network's 60 largest pools by 24h volume
returnednumberyes1
matchednumberyes7
completebooleanyesfalse
truncatedbooleanyestrue
totalsobjectyes6 fields: volume24hUsd, liquidityUsd, turnover, dexes, topDexSharePct, hhi
dexesarray of objectsyes1 item in the example
flagsarray of stringyes1 item in the example
creditstringyesData 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

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

$0.005GET /api/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

$0.005GET /api/chain-board

Blockchains ranked by their native asset, computed from three market documents: each native asset's share of the whole.

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.

Exchange tickers

$0.008GET /api/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

$0.003POST /api/sol-token-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

$0.005GET /api/coin-categories

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