Name: defi-tvl
Price: 0.02 USDC
Availability: InStock

$ man defi-tvl

agentutility / edge-market / defi-tvl

PRICE / CALL

$0.02

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

edgemarket

CATEGORY

uncategorized

STATUS

● live

NAME

defi-tvl — defi tvl api / total value locked by protocol

synonym alias of defi-llama-protocol — reuses the canonical handler.

SYNOPSIS

POST https://x402.agentutility.ai/defi-tvl
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

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

DESCRIPTION

DeFi TVL API / total value locked by protocol. Looks up one DefiLlama protocol slug and returns current USD TVL, chain TVL breakdown, TVL changes, protocol metadata, and attribution.

INPUT — request schema

property	type	description	req?
protocol	string	DefiLlama slug (lowercase, hyphenated). Examples: 'aave', 'lido', 'uniswap', 'makerdao', 'curve-dex'. See defillama.com/protocols for the canonical slug list.	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
protocol_slug	string	—
name	string	—
symbol	string	—
category	string	—
chain	string	—
parent_protocol	string	—
url	string	—
twitter	string	—
audits	string	—
audit_links	string	—
description	string	—
logo	string	—
current_tvl_usd	string	—
chain_tvl_breakdown	string	—
tvl_summary	string	—
attribution	string	—

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/defi-tvl \
  -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 defi-tvl tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: edge-marketdefitvldefi-tvl
methods: POST
cluster: edgemarket
price: $0.02 USDC per call

ADJACENT — other endpoints in edgemarket

endpoint	description	price
defi-llama	DefiLlama API / DeFi TVL protocol lookup.	$0.02
defi-llama-api	Looks up DeFi protocol fundamentals from DefiLlama, resolving protocol TVL, category, chains, token symbol, and protocol metadata.	$0.02
defi-llama-protocol	Looks up any DeFi protocol's TVL and metadata from DefiLlama.	$0.02
defillama	DefiLlama protocol TVL lookup / DeFi protocol metadata.	$0.02
gas-api	Estimates blockchain gas fees with EIP-1559 tiers for Base, Ethereum, Optimism, and Arbitrum.	$0.02
gas-fees	Estimates EIP-1559 transaction fees on Base, Ethereum, Optimism, and Arbitrum.	$0.02
gas-now-base	Real-time gas price oracle for Base, Ethereum, Optimism, Arbitrum, and Polygon.	$0.02
gas-price	Estimates current gas prices and EIP-1559 fees on Base, Ethereum, Optimism, and Arbitrum.	$0.02