get_protocol_tvl
Retrieve a protocol's metadata, current TVL across chains, and a trimmed history of daily total liquidity USD. Use after listing protocols to analyze one protocol's TVL trend per chain.
Instructions
Get a single protocol's metadata, current TVL, and recent TVL history.
Use after list_protocols to drill into one protocol — e.g. "what is
Aave's TVL on each chain?" or "show me Lido's last 90 days of TVL."
The raw DefiLlama response is enormous (multi-year daily series for the
overall protocol AND every chain it touches), so this tool trims each
history series to the last history_days daily points and drops the
per-token breakdown arrays (tokens, tokensInUsd).
Args:
slug: Protocol slug from list_protocols (e.g. "aave-v3", "lido",
"uniswap-v3"). NOT a CoinGecko coin ID.
history_days: Number of trailing daily points to keep for each TVL
series. Default 90; use a smaller value for compactness or a
larger value (up to ~1500) for long-range analysis.
Returns:
Protocol object with id, name, symbol, category, chains,
chain, description, url, mcap, currentChainTvls (snapshot
per chain), tvl (recent series of {date, totalLiquidityUSD}), and
chainTvls (per-chain trimmed series).
Note: slug is validated against ^[a-z0-9][a-z0-9._-]{0,127}$.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | ||
| history_days | No |