DeFi protocols ranked by TVL
POST /api/defi-protocolsDeFi protocols ranked by current TVL from DefiLlama's free protocol list: filter by category (Lending, Dexs, Liquid Staking, CDP, Yield...), chain (ranks by that chain's TVL), or a name search; limit up to 100. Rows carry global rank, name, slug, category, chains, TVL, 1h/1d/7d TVL change, market cap and mcap/TVL. CEX rows are excluded unless category is CEX or includeCex is true. The ~8.6MB upstream document is cached 5 minutes in-process. Keyless public data.
Input
| Field | Type | Description |
|---|---|---|
category | string | Category filter (Lending, Dexs, Liquid Staking, Restaking, CDP, Yield, Derivatives, Bridge, RWA, CEX...). Case-insensitive exact match. |
chain | string | Chain filter as DefiLlama names it (Ethereum, Base, Solana, Arbitrum...). Rows are then ranked by TVL on that chain. |
search | string | Name/slug substring filter (case-insensitive). |
includeCex | boolean | Include centralized-exchange reserve rows (default false). |
minTvlUsd | number | Minimum TVL in USD. |
limit | number | Rows to return (default 25, max 100). |
Example output
{
"source": "defillama-protocols",
"fetchedAt": "2026-08-22T12:00:00.000Z",
"cached": true,
"filters": {
"category": "Lending",
"chain": null,
"search": null,
"includeCex": false,
"minTvlUsd": null
},
"totalTvlUsd": 48000000000,
"matched": 600,
"count": 1,
"protocols": [
{
"rank": 3,
"name": "Aave V3",
"slug": "aave-v3",
"category": "Lending",
"chains": [
"Ethereum",
"Base",
"Arbitrum"
],
"chainCount": 21,
"tvlUsd": 17023522168,
"change1hPct": 0.02,
"change1dPct": 0.8,
"change7dPct": 2.4,
"mcapUsd": 3200000000,
"mcapTvl": 0.188,
"symbol": "AAVE",
"parentProtocol": "aave"
}
]
}
Try it - see the 402 challenge (free)
curl -i -X POST https://agent402.tools/api/defi-protocols \
-H "Content-Type: application/json" \
-d '{"category":"Lending","limit":5}'
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/defi-protocols", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"category": "Lending",
"limit": 5
}),
});
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 →