DeFi protocol profile
POST /api/defi-protocolProfile of one DeFi protocol by DefiLlama slug (aave-v3, uniswap-v3, lido, morpho-v1...): TVL rank among all protocols, category, chains, current TVL by chain (borrowed/staking/pool2 reported separately, never summed into TVL), 1h/1d/7d TVL change, market cap and mcap/TVL, token symbol + address, website, X handle, audit count/links, listing date and parent protocol. Unknown slugs answer 422 with up to 5 name suggestions. Served from the cached protocol list (no per-protocol history fetch; use defi-tvl for a protocol's full TVL history). Keyless public data.
Input
| Field | Type | Description |
|---|---|---|
protocol * | string | DefiLlama protocol slug (lowercase, hyphenated), e.g. aave-v3, uniswap-v3, lido, morpho-v1. |
Example output
{
"source": "defillama-protocols",
"fetchedAt": "2026-08-22T12:00:00.000Z",
"cached": true,
"protocol": {
"rank": 3,
"name": "Aave V3",
"slug": "aave-v3",
"category": "Lending",
"chains": [
"Ethereum",
"Base"
],
"chainCount": 21,
"tvlUsd": 17023522168,
"change1hPct": 0.02,
"change1dPct": 0.8,
"change7dPct": 2.4,
"mcapUsd": 3200000000,
"mcapTvl": 0.188,
"symbol": "AAVE",
"address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
"geckoId": null,
"url": "https://aave.com",
"twitter": "aave",
"audits": 2,
"auditLinks": [
"https://aave.com/security"
],
"listedAt": "2022-04-01",
"parentProtocol": "aave",
"description": "Earn interest, borrow assets, and build applications",
"logo": "https://icons.llamao.fi/icons/protocols/aave-v3",
"chainTvls": [
{
"chain": "Ethereum",
"tvlUsd": 12000000000
}
],
"borrowedUsd": 9000000000,
"stakingUsd": null,
"pool2Usd": null
}
}
Try it - see the 402 challenge (free)
curl -i -X POST https://agent402.tools/api/defi-protocol \
-H "Content-Type: application/json" \
-d '{"protocol":"aave-v3"}'
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-protocol", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"protocol": "aave-v3"
}),
});
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 →