Crypto categories by market cap
GET /api/coin-categoriesCoin categories (Layer 1, Meme, AI, DeFi, Stablecoins, RWA, ...) ranked by market cap, with 24h market cap change %, 24h volume and the top-3 coins per category. Order by market_cap_desc (default), market_cap_asc, market_cap_change_24h_desc/asc, name_asc/desc; optional `query` substring filter on category name/id; limit 1-100 (default 25). The sector-rotation view: which narratives are gaining or bleeding today. Cached in-process for 5 minutes.
Input
| Field | Type | Description |
|---|---|---|
order | string | market_cap_desc (default), market_cap_asc, market_cap_change_24h_desc, market_cap_change_24h_asc, name_asc, name_desc. |
limit | number | 1-100 (default 25). |
query | string | Optional case-insensitive substring filter on the category name or id (e.g. "meme", "layer-2"). |
Example output
{
"source": "coingecko",
"fetchedAt": "2026-08-22T13:20:00.000Z",
"cached": false,
"order": "market_cap_desc",
"count": 1,
"totalCategories": 400,
"categories": [
{
"rank": 1,
"id": "smart-contract-platform",
"name": "Smart Contract Platform",
"marketCap": 2261471553524.96,
"marketCapChange24hPct": 1.1784,
"volume24h": 95000000000,
"topCoins": [
"bitcoin",
"ethereum",
"solana"
],
"updatedAt": "2026-08-22T13:15:00.000Z"
}
]
}
Try it - see the 402 challenge (free)
curl -i "https://agent402.tools/api/coin-categories?order=market_cap_desc&limit=10"
The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:
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();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/api/coin-categories?order=market_cap_desc&limit=10");
Related tools
Crypto order book
GET /api/crypto-orderbookL2 order-book snapshot for a spot pair: best bid/ask, mid price, spread (absolute + %), and the top N aggregated price l…
try in playground →Stablecoin peg monitor
GET /api/stablecoin-pegLive $1-peg deviation for the top USD stablecoins (USDT, USDC, USDS, DAI, USDe, PYUSD, USDD, TUSD, FDUSD by default, or …
try in playground →Wallet balance (native + ERC-20)
POST /api/wallet-balanceLook up the native coin balance (ETH/MATIC) plus every ERC-20 holding for a wallet address on Ethereum, Base, Polygon, A…
try in playground →