$ man defi-llama-protocol
/defi-llama-protocol(1)
PRICE / CALL
$0.02
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgemarketCATEGORY
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.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| protocol | string | DefiLlama slug (e.g. 'aave', 'lido'). | required |
| include_tvl_series | boolean | If true, attach the full historical TVL time-series under tvl_summary.series. Adds significant payload size. Default false. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| current_tvl_usd | string | Current total value locked across all chains for the protocol, denominated in USD. |
| name | string | Protocol name as listed on DefiLlama (e.g., Aave, Uniswap, Lido). |
EXAMPLES — two 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
ADJACENT — other endpoints in edgemarket
| endpoint | description | price |
|---|---|---|
| gas-now-base | Gas oracle / EIP-1559 fee estimator. | $0.02 |
| gas-price | Gas price API / EIP-1559 fee estimator / Base + Ethereum + Optimism + Arbitrum gas tracker / pre-tx cost estimator. | $0.02 |
| token-price | Crypto token price API / CoinGecko wrapper. | $0.02 |
| tx-receipt-decode | EVM transaction receipt decoder / log decoder / event log reader / Etherscan tx debug / receipt parser / Basescan tx explainer / tenderly… | $0.02 |
| tx-simulate-swap | Tx simulate swap / pre-trade quote / DEX swap simulator / 1inch + LlamaSwap quote / would-it-succeed check. | $0.02 |
| bridge-rates | Cross-chain bridge rate aggregator. | $0.03 |
| dao-proposal-monitor | Snapshot.org DAO proposal monitor. | $0.03 |
| ens-resolve | ENS resolver / Ethereum Name Service lookup. | $0.03 |
SEE ALSO