Protocol TVL Lookup

Look up a DeFi protocol's reported total value locked, chain breakdown, category, audit information and recent changes.

Pay by wallet (x402) protocol-tvl-lookup

Example

Input

{
  "protocol": "aave-v3"
}

Answer

{
  "url": "https://aave.com",
  "name": "Aave V3",
  "slug": "aave-v3",
  "audits": 2,
  "chains": [
    "Fantom",
    "Harmony",
    "Base",
    "Avalanche",
    "Soneium",
    "Scroll",
    "Ethereum",
    "Metis",
    "Arbitrum",
    "Binance",
    "MegaETH",
    "Sonic",
    "Plasma",
    "Optimism",
    "Celo",
    "Mantle",
    "Linea",
    "xDai",
    "zkSync Era",
    "Polygon",
    "X Layer"
  ],
  "github": [],
  "symbol": "AAVE",
  "tvl_usd": 23352261394,
  "twitter": "aave",
  "category": "Lending",
  "chain_tvls": {
    "Base": 707862049,
    "Celo": 10691092,
    "xDai": 63524255,
    "Linea": 45262753,
    "Metis": 542728,
    "Sonic": 11482126,
    "Fantom": 3646,
    "Mantle": 547803793,
    "Plasma": 1429883904,
    "Scroll": 6733463,
    "Binance": 179301495,
    "Harmony": 0,
    "MegaETH": 22645982,
    "Polygon": 142978163,
    "Soneium": 462151,
    "X Layer": 88377,
    "Arbitrum": 733702906,
    "Ethereum": 19017359023,
    "Optimism": 53605103,
    "Avalanche": 376136796,
    "zkSync Era": 2191578
  },
  "audit_links": [
    "https://aave.com/security"
  ],
  "description": "Earn interest, borrow assets, and build applications",
  "listed_since": "2022-04-01T01:34:37.000Z",
  "is_open_source": false,
  "tvl_change_1d_pct": null,
  "tvl_change_7d_pct": null
}

Inputs

Field	Type	Required	What it is
`protocol`	string	Yes	Protocol name or DeFi Llama slug (e.g., 'aave', 'uniswap', 'compound')

Output fields

How reliably each field appears in a successful answer.

Field	Type	Appears
`url`	string	Usually (present for most inputs)
`name`	string	Usually (present for most inputs)
`slug`	string	Usually (present for most inputs)
`audits`	number	Usually (present for most inputs)
`chains`	array	Usually (present for most inputs)
`tvl_usd`	number	Usually (present for most inputs)
`twitter`	string	Usually (present for most inputs)
`category`	string	Usually (present for most inputs)
`audit_links`	array	Usually (present for most inputs)
`listed_since`	string	Usually (present for most inputs)
`is_open_source`	boolean	Usually (present for most inputs)
`tvl_change_1d_pct`	number	Usually (present for most inputs)
`tvl_change_7d_pct`	number	Usually (present for most inputs)

How to call it

The same tool through each route. MCP clients reach it through Strale’s server at https://api.strale.io/mcp; the call below is what the agent sends.

# Needs an API key. max_price_cents caps what this call may cost.
curl -X POST https://api.strale.io/v1/do \
  -H "Authorization: Bearer $STRALE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "capability_slug": "protocol-tvl-lookup",
    "inputs": {
      "protocol": "aave-v3"
    },
    "max_price_cents": 2
  }'

{
  "tool": "strale_execute",
  "arguments": {
    "slug": "protocol-tvl-lookup",
    "inputs": {
      "protocol": "aave-v3"
    },
    "max_price_cents": 2
  }
}

import { Strale } from "straleio";

const strale = new Strale({ apiKey: process.env.STRALE_API_KEY! });
const result = await strale.do({
  capability_slug: "protocol-tvl-lookup",
  inputs: {
    "protocol": "aave-v3"
  },
  max_price_cents: 2,
});

import os
from straleio import Strale, DoRequest

strale = Strale(api_key=os.environ["STRALE_API_KEY"])
result = strale.do(DoRequest(
    capability_slug="protocol-tvl-lookup",
    inputs={
        "protocol": "aave-v3",
    },
    max_price_cents=2,
))

# No account. The first request answers 402 with the price in USDC;
# an x402 client pays it from your wallet and repeats the request.
curl -i 'https://api.strale.io/x402/v2/protocol-tvl-lookup?protocol=aave-v3'

Limitations

Output reflects DefiLlama (Protocol TVL API) at query time. Dependent on upstream API availability; may degrade if the provider rate-limits or is temporarily unavailable.

Bundled checks that include it

Web3 Protocol Health Report €0.08