Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint
$ man defi-llama-protocol

/defi-llama-protocol(1)

agentutility / edge-market / defi-llama-protocol
PRICE / CALL
$0.02
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgemarket
CATEGORY
uncategorized
STATUS
live
NAME
defi-llama-protocol defillama protocol lookup — tvl, chain breakdown, current tvl, 24h/7d/30d changes, audits, parent protocol, categories
SYNOPSIS
POST https://x402.org/v1/defi-llama-protocol
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }
↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.
DESCRIPTION

DefiLlama protocol lookup — TVL, chain breakdown, current TVL, 24h/7d/30d changes, audits, parent protocol, categories. Free public API with attribution.

INPUTrequest schema
propertytypedescriptionreq?
protocolstringDefiLlama slug (e.g. 'aave', 'lido').required
include_tvl_seriesbooleanIf true, attach the full historical TVL time-series under tvl_summary.series. Adds significant payload size. Default false.optional
OUTPUTresponse shape
fieldtypedescription
current_tvl_usdstringCurrent total value locked across all chains for the protocol, denominated in USD.
namestringProtocol name as listed on DefiLlama (e.g., Aave, Uniswap, Lido).
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/defi-llama-protocol \
  -H 'Content-Type: application/json' \
  -d '{ }'
first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.
EXAMPLE 2 · mcp
# install once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the defi-llama-protocol tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
defitvlprotocol-lookuponchain-datadefillama
methods
POST
cluster
edgemarket
price
$0.02 USDC per call
ADJACENTother endpoints in edgemarket
endpointdescriptionprice
gas-now-baseGas oracle / EIP-1559 fee estimator.$0.02
gas-priceGas price API / EIP-1559 fee estimator / Base + Ethereum + Optimism + Arbitrum gas tracker / pre-tx cost estimator.$0.02
token-priceCrypto token price API / CoinGecko wrapper.$0.02
tx-receipt-decodeEVM transaction receipt decoder / log decoder / event log reader / Etherscan tx debug / receipt parser / Basescan tx explainer / tenderly…$0.02
tx-simulate-swapTx simulate swap / pre-trade quote / DEX swap simulator / 1inch + LlamaSwap quote / would-it-succeed check.$0.02
bridge-ratesCross-chain bridge rate aggregator.$0.03
dao-proposal-monitorSnapshot.org DAO proposal monitor.$0.03
ens-resolveENS resolver / Ethereum Name Service lookup.$0.03
SEE ALSO
agentutility(7) · edgemarket(7) · x402(7) · mcp(7) · llms.txt · registry.json · bazaar.x402.org