What does TVL measure?

TVL measures the dollar-denominated balance of all assets locked in a DeFi protocol's smart contracts — lending pool deposits, AMM liquidity, staked tokens, vault deposits, and so on. It excludes idle wallet balances and protocol-owned but uninvested treasury funds.

Why does TVL matter for AI agents?

TVL is the proxy for protocol scale, yield reliability, and economic gravity. An agent comparing two yield pools needs to know not just APY but the TVL behind that APY — a 50% APY on a $100K pool is far riskier than 5% APY on a $1B pool. TVL also indicates the cost of an attack: protocols with low TVL relative to attack profit are more vulnerable to oracle manipulation and governance exploits.

How does Hive expose TVL data?

Hive's DeFiLlama upstream surfaces protocol-wide TVL, chain-level TVL, vault-level TVL, and historical TVL series through a normalized MCP tool set — get_protocol_tvl, get_chain_tvl, get_yields_pools, and related. CoinGecko MCP, Birdeye, Codex, and DexScreener do not aggregate protocol-wide TVL.

Is TVL a perfect metric?

No. TVL counts the same dollar twice if a token is deposited, yield-farmed, then re-deposited (recursive leverage). It also doesn't account for token-price volatility — TVL drops mechanically when the price of the deposited asset falls, even if the protocol is fundamentally healthy. DeFiLlama publishes a 'TVL by category' breakdown that normalizes for some of these effects.

What is TVL? | Total Value Locked Definition for DeFi Agents

TVL — Total Value Locked — is the dollar-value sum of all assets deposited in a DeFi protocol's smart contracts. It is the standard health metric for DeFi.

A protocol with $1B TVL has $1B in user-deposited assets across its lending pools, AMMs, vaults, and staking contracts. A protocol with $1M TVL has 1/1000th the economic gravity, and proportionately higher risk on every metric — APY sustainability, attack profitability, oracle integrity, withdrawal liquidity.

Why AI agents care

Two protocols offering 8% APY with very different TVLs mean very different things. The $1B-TVL protocol has likely been audited, has battle-tested fee revenue, and has enough liquidity that user withdrawals don't move the price meaningfully. The $1M-TVL protocol is either too new, too risky, or attracting yield only via emissions of an unsustainable token.

Hive's get_yields_pools tool returns TVL alongside APY for every yield pool DefiLlama tracks — so an agent can sort by APY × TVL ratio rather than naked APY. Single-provider APIs like CoinGecko MCP and Codex do not expose protocol-wide TVL.

Why AI agents care

Related terms