Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint · rollforge · bestiary · statline · matchpoint · retail · agentops · browserworkflow · modelrouter · compose
$ man defillama

/defillama

PRICE / CALL
$0.02
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgemarket
CATEGORY
uncategorized
STATUS
live
NAME
defillama defillama protocol tvl lookup / defi protocol metadata
synonym alias of defi-llama-protocol — reuses the canonical handler.
SYNOPSIS
POST https://x402.agentutility.ai/defillama
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

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

DefiLlama protocol TVL lookup / DeFi protocol metadata. Same backend as defi-llama-protocol with a compact slug for buyers searching DefiLlama directly.

INPUTrequest schema
propertytypedescriptionreq?
protocolstringDefiLlama slug (lowercase, hyphenated). Examples: 'aave', 'lido', 'uniswap', 'makerdao', 'curve-dex'. See defillama.com/protocols for the canonical slug list.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
protocol_slugstring
namestring
symbolstring
categorystring
chainstring
parent_protocolstring
urlstring
twitterstring
auditsstring
audit_linksstring
descriptionstring
logostring
current_tvl_usdstring
chain_tvl_breakdownstring
tvl_summarystring
attributionstring
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/defillama \
  -H 'Content-Type: application/json' \
  -d '{ }'
first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.
EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the defillama tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
edge-marketdefillama
methods
POST
cluster
edgemarket
price
$0.02 USDC per call
ADJACENTother endpoints in edgemarket
endpointdescriptionprice
defi-llamaDefiLlama API / DeFi TVL protocol lookup.$0.02
defi-llama-apiLooks up DeFi protocol fundamentals from DefiLlama, resolving protocol TVL, category, chains, token symbol, and protocol metadata.$0.02
defi-llama-protocolLooks up any DeFi protocol's TVL and metadata from DefiLlama.$0.02
defi-tvlDeFi TVL API / total value locked by protocol.$0.02
gas-apiEstimates blockchain gas fees with EIP-1559 tiers for Base, Ethereum, Optimism, and Arbitrum.$0.02
gas-feesEstimates EIP-1559 transaction fees on Base, Ethereum, Optimism, and Arbitrum.$0.02
gas-now-baseReal-time gas price oracle for Base, Ethereum, Optimism, Arbitrum, and Polygon.$0.02
gas-priceEstimates current gas prices and EIP-1559 fees on Base, Ethereum, Optimism, and Arbitrum.$0.02
SEE ALSO
agentutility · edgemarket · x402 · mcp · llms.txt · registry.json · bazaar.x402.org