What is TVL (Total Value Locked)?

Written by , Product docsLast updated

TVL — Total Value Locked — is the dollar-value sum of all assets deposited in a DeFi protocol's smart contracts. It is a common health and scale 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 deposited capital, which usually raises more diligence questions around APY sustainability, attack profitability, oracle design, and withdrawal liquidity.


Why AI agents care

Two protocols offering 8% APY with very different TVLs mean very different things. The $1B-TVL protocol may have deeper liquidity, a longer operating history, or more public diligence available. The $1M-TVL protocol needs closer review because yield can be driven by shallow liquidity, short-lived emissions, or thin withdrawal depth.

Hive's get_yield_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.


Common mistakes

Agents should not rank yield opportunities by APY alone. A high APY with low TVL can disappear quickly, and recursive deposits can make TVL look larger than the durable capital actually at risk. Pair TVL with fees, revenue, audits, and liquidity depth before recommending a pool.