Catalog
CryptoGETlive

DeFi protocol TVL

Fetch TVL, chain breakdown, and history for a DeFi protocol by slug.

$0.007
per call
Success
100%
p50 latency
4.98s
p95 latency
5.13s
Calls (30d)
2

Provider contract

Call path
/routes/blockrun-defillama/crypto/defi-tvl
Method
GET
Selected provider
blockrun-defillamadefault
Provider price
$0.007
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl '/routes/blockrun-defillama/crypto/defi-tvl?slug=aave'
CLI
h402 call 'crypto/defi-tvl' --provider 'blockrun-defillama' --method GET --query '{"slug":"aave"}'

Parameters & live test

pays real USDC

Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.

slugstringrequired

DefiLlama protocol slug.

e.g.
GET/routes/blockrun-defillama/crypto/defi-tvl
Request query
{
  "slug": "aave"
}

ResponseExample response
{
  "data": {
    "id": "parent#aave",
    "name": "Aave",
    "url": "https://aave.com",
    "description": "Aave is an Open Source and Non-Custodial protocol to earn interest on deposits and borrow assets",
    "logo": "https://icons.llamao.fi/icons/protocols/aave",
    "chains": [],
    "gecko_id": "aave",
    "cmcId": "7278",
    "treasury": "aave.js",
    "twitter": "aave",
    "governanceID": [
      "snapshot:aave.eth",
      "eip155:1:0xEC568fffba86c094cf06b22134B23074DFE2252c"
    ],
    "wrongLiquidity": true,
    "github": [
      "aave",
      "aave-dao"
    ],
    "stablecoins": [
      "gho"
    ],
    "symbol": "AAVE",
    "address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
    "currentChainTvls": {
      "Ethereum-staking": 218696894,
      "Ethereum-pool2": 864721,
      "Ethereum": 12093042442,
      "Ethereum-borrowed": 8757763917,
      "Avalanche-borrowed": 139622314,
      "Polygon-borrowed": 53994947,
      "Avalanche": 236765852,
      "Polygon": 132707537,
      "staking": 218696894,
      "pool2": 864721,
      "borrowed": 10978830010,
      "Base-borrowed": 315591467,
      "Base": 431470870,
      "Linea-borrowed": 6700368,
      "Soneium": 140818,
      "Soneium-borrowed": 38603,
      "Metis-borrowed": 31237,
      "BSC-borrowed": 67972824,
      "Harmony": 0,
      "Sonic-borrowed": 2819593,
      "Scroll-borrowed": 427759,
      "Metis": 274102,
      "Sonic": 5149121,
      "Linea": 11504151,
      "OP Mainnet-borrowed": 28778081
    },
    "chainTvls": {
      "Ethereum-staking": {
        "tvl": [
          {
            "date": 1606953600,
            "totalLiquidityUSD": 244094753
          },
          {
            "date": 1607040000,
            "totalLiquidityUSD": 243189473
          },
          {
            "date": 1607126400,
            "totalLiquidityUSD": 250327449
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Ethereum-pool2": {
        "tvl": [
          {
            "date": 1606953600,
            "totalLiquidityUSD": 0
          },
          {
            "date": 1607040000,
            "totalLiquidityUSD": 0
          },
          {
            "date": 1607126400,
            "totalLiquidityUSD": 0
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Ethereum": {
        "tvl": [
          {
            "date": 1589932800,
            "totalLiquidityUSD": 54026260
          },
          {
            "date": 1590019200,
            "totalLiquidityUSD": 57638725
          },
          {
            "date": 1590105600,
            "totalLiquidityUSD": 56713126
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Ethereum-borrowed": {
        "tvl": [
          {
            "date": 1589932800,
            "totalLiquidityUSD": 12345606
          },
          {
            "date": 1590019200,
            "totalLiquidityUSD": 12298508
          },
          {
            "date": 1590105600,
            "totalLiquidityUSD": 12404565
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Avalanche-borrowed": {
        "tvl": [
          {
            "date": 1632182400,
            "totalLiquidityUSD": 0
          },
          {
            "date": 1632268800,
            "totalLiquidityUSD": 0
          },
          {
            "date": 1632355200,
            "totalLiquidityUSD": 0
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Polygon-borrowed": {
        "tvl": [
          {
            "date": 1617235200,
            "totalLiquidityUSD": 90847
          },
          {
            "date": 1617321600,
            "totalLiquidityUSD": 265749
          },
          {
            "date": 1617408000,
            "totalLiquidityUSD": 664101
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Avalanche": {
        "tvl": [
          {
            "date": 1632182400,
            "totalLiquidityUSD": 0
          },
          {
            "date": 1632268800,
            "totalLiquidityUSD": 0
          },
          {
            "date": 1632355200,
            "totalLiquidityUSD": 0
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Polygon": {
        "tvl": [
          {
            "date": 1617235200,
            "totalLiquidityUSD": 778520
          },
          {
            "date": 1617321600,
            "totalLiquidityUSD": 1386996
          },
          {
            "date": 1617408000,
            "totalLiquidityUSD": 2156432
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "staking": {
        "tvl": [
          {
            "date": 1606953600,
            "totalLiquidityUSD": 244094753
          },
          {
            "date": 1607040000,
            "totalLiquidityUSD": 243189473
          },
          {
            "date": 1607126400,
            "totalLiquidityUSD": 250327449
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "pool2": {
        "tvl": [
          {
            "date": 1606953600,
            "totalLiquidityUSD": 0
          },
          {
            "date": 1607040000,
            "totalLiquidityUSD": 0
          },
          {
            "date": 1607126400,
            "totalLiquidityUSD": 0
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "borrowed": {
        "tvl": [
          {
            "date": 1589932800,
            "totalLiquidityUSD": 12345606
          },
          {
            "date": 1590019200,
            "totalLiquidityUSD": 12298508
          },
          {
            "date": 1590105600,
            "totalLiquidityUSD": 12404565
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Base-borrowed": {
        "tvl": [
          {
            "date": 1692748800,
            "totalLiquidityUSD": 3262
          },
          {
            "date": 1692835200,
            "totalLiquidityUSD": 27893
          },
          {
            "date": 1692921600,
            "totalLiquidityUSD": 30819
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Base": {
        "tvl": [
          {
            "date": 1692748800,
            "totalLiquidityUSD": 13595
          },
          {
            "date": 1692835200,
            "totalLiquidityUSD": 45994
          },
          {
            "date": 1692921600,
            "totalLiquidityUSD": 110457
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Linea-borrowed": {
        "tvl": [
          {
            "date": 1739404800,
            "totalLiquidityUSD": 728026
          },
          {
            "date": 1739491200,
            "totalLiquidityUSD": 902667
          },
          {
            "date": 1739577600,
            "totalLiquidityUSD": 1252006
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Soneium": {
        "tvl": [
          {
            "date": 1749168000,
            "totalLiquidityUSD": 1401655
          },
          {
            "date": 1749254400,
            "totalLiquidityUSD": 1410276
          },
          {
            "date": 1749340800,
            "totalLiquidityUSD": 1411057
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Soneium-borrowed": {
        "tvl": [
          {
            "date": 1749168000,
            "totalLiquidityUSD": 26
          },
          {
            "date": 1749254400,
            "totalLiquidityUSD": 26
          },
          {
            "date": 1749340800,
            "totalLiquidityUSD": 32
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Metis-borrowed": {
        "tvl": [
          {
            "date": 1683590400,
            "totalLiquidityUSD": 74346
          },
          {
            "date": 1683676800,
            "totalLiquidityUSD": 75475
          },
          {
            "date": 1683763200,
            "totalLiquidityUSD": 67839
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "BSC-borrowed": {
        "tvl": [
          {
            "date": 1707868800,
            "totalLiquidityUSD": 3767711
          },
          {
            "date": 1707955200,
            "totalLiquidityUSD": 4022296
          },
          {
            "date": 1708041600,
            "totalLiquidityUSD": 4612325
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Harmony": {
        "tvl": [
          {
            "date": 1647216000,
            "totalLiquidityUSD": 0
          },
          {
            "date": 1647302400,
            "totalLiquidityUSD": 0
          },
          {
            "date": 1647388800,
            "totalLiquidityUSD": 2
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Sonic-borrowed": {
        "tvl": [
          {
            "date": 1741132800,
            "totalLiquidityUSD": 7170854
          },
          {
            "date": 1741219200,
            "totalLiquidityUSD": 15189673
          },
          {
            "date": 1741305600,
            "totalLiquidityUSD": 21529577
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Scroll-borrowed": {
        "tvl": [
          {
            "date": 1707868800,
            "totalLiquidityUSD": 150770
          },
          {
            "date": 1707955200,
            "totalLiquidityUSD": 233802
          },
          {
            "date": 1708041600,
            "totalLiquidityUSD": 237875
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Metis": {
        "tvl": [
          {
            "date": 1683590400,
            "totalLiquidityUSD": 519439
          },
          {
            "date": 1683676800,
            "totalLiquidityUSD": 516119
          },
          {
            "date": 1683763200,
            "totalLiquidityUSD": 514367
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Sonic": {
        "tvl": [
          {
            "date": 1741132800,
            "totalLiquidityUSD": 40250410
          },
          {
            "date": 1741219200,
            "totalLiquidityUSD": 43958698
          },
          {
            "date": 1741305600,
            "totalLiquidityUSD": 51028540
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "Linea": {
        "tvl": [
          {
            "date": 1739404800,
            "totalLiquidityUSD": 1639513
          },
          {
            "date": 1739491200,
            "totalLiquidityUSD": 2704979
          },
          {
            "date": 1739577600,
            "totalLiquidityUSD": 2891430
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      },
      "OP Mainnet-borrowed": {
        "tvl": [
          {
            "date": 1647216000,
            "totalLiquidityUSD": 0
          },
          {
            "date": 1647302400,
            "totalLiquidityUSD": 0
          },
          {
            "date": 1647388800,
            "totalLiquidityUSD": 0
          }
        ],
        "tokensInUsd": null,
        "tokens": null
      }
    },
    "tokens": [
      {
        "date": 1589932800,
        "tokens": {
          "ZRX": 635513.63715,
          "MANA": 2361387.30781,
          "USDT": 2918703.28861,
          "WETH": 27995.69606,
          "LEND": 263912681.33932,
          "DAI": 1913939.12256,
          "KNCL": 2853268.86176,
          "UNKNOWN (0x1985365e9f78359a9B6AD760e32412f4a445E862)": 0,
          "WBTC": 94.27992,
          "SUSD": 54066.49116,
          "TUSD": 170182.03868,
          "BAT": 1792178.22175,
          "MKR": 810.66287,
          "LINK": 5743118.64061,
          "USDC": 2050328.58009,
          "BUSD": 45902.47036,
          "SNX": 122478.3059
        }
      },
      {
        "date": 1590019200,
        "tokens": {
          "ZRX": 596450.36434,
          "MANA": 3260688.94223,
          "USDT": 2918104.39134,
          "WETH": 27876.93571,
          "LEND": 264911161.07269,
          "DAI": 1838175.94959,
          "KNCL": 2856877.51038,
          "UNKNOWN (0x1985365e9f78359a9B6AD760e32412f4a445E862)": 0,
          "WBTC": 92.7539,
          "SUSD": 57631.94457,
          "TUSD": 152442.4912,
          "BAT": 1791584.32533,
          "MKR": 814.48361,
          "LINK": 5743218.86928,
          "USDC": 2639634.09834,
          "BUSD": 45891.21606,
          "SNX": 194169.71582
        }
      },
      {
        "date": 1590105600,
        "tokens": {
          "ZRX": 620392.83649,
          "MANA": 2845633.90578,
          "USDT": 2814683.44232,
          "WETH": 27962.12236,
          "LEND": 264734537.01343,
          "DAI": 1704595.39615,
          "KNCL": 2923577.89435,
          "UNKNOWN (0x1985365e9f78359a9B6AD760e32412f4a445E862)": 0,
          "WBTC": 92.71728,
          "SUSD": 60074.92254,
          "TUSD": 227704.62186,
          "BAT": 1794352.93405,
          "MKR": 815.3388,
          "LINK": 5779429.93775,
          "USDC": 2433883.20287,
          "BUSD": 64171.14897,
          "SNX": 183561.36004
        }
      }
    ],
    "tokensInUsd": [
      {
        "date": 1589932800,
        "tokens": {
          "ZRX": 230428.25632,
          "MANA": 88072.39169,
          "USDT": 2920443.78219,
          "WETH": 5944444.67404,
          "LEND": 14987355.50652,
          "DAI": 1919430.83155,
          "KNCL": 1822600.42115,
          "UNKNOWN (0x1985365e9f78359a9B6AD760e32412f4a445E862)": 0,
          "WBTC": 913613.5134,
          "SUSD": 54095.62096,
          "TUSD": 169720.1993,
          "BAT": 368714.69822,
          "MKR": 266705.02232,
          "LINK": 22146066.508,
          "USDC": 2045465.91864,
          "BUSD": 46032.09949,
          "SNX": 103070.92941
        }
      },
      {
        "date": 1590019200,
        "tokens": {
          "ZRX": 222038.54353,
          "MANA": 124201.00809,
          "USDT": 2916023.11185,
          "WETH": 5934209.87952,
          "LEND": 16848426.28384,
          "DAI": 1843465.86141,
          "KNCL": 1847443.66997,
          "UNKNOWN (0x1985365e9f78359a9B6AD760e32412f4a445E862)": 0,
          "WBTC": 913308.45247,
          "SUSD": 57459.3695,
          "TUSD": 152307.82199,
          "BAT": 372918.78236,
          "MKR": 264447.49053,
          "LINK": 23296167.27079,
          "USDC": 2638075.27992,
          "BUSD": 45887.14498,
          "SNX": 162345.88416
        }
      },
      {
        "date": 1590105600,
        "tokens": {
          "ZRX": 219183.9122,
          "MANA": 107984.19654,
          "USDT": 2813130.34564,
          "WETH": 5789783.80561,
          "LEND": 16371744.72461,
          "DAI": 1709869.02528,
          "KNCL": 1882128.11279,
          "UNKNOWN (0x1985365e9f78359a9B6AD760e32412f4a445E862)": 0,
          "WBTC": 867426.07862,
          "SUSD": 60308.56364,
          "TUSD": 227984.54814,
          "BAT": 364619.85606,
          "MKR": 260498.49663,
          "LINK": 23391533.49678,
          "USDC": 2435560.14979,
          "BUSD": 64174.95832,
          "SNX": 147196.31365
        }
      }
    ],
    "tvl": [
      {
        "date": 1589932800,
        "totalLiquidityUSD": 54026260
      },
      {
        "date": 1590019200,
        "totalLiquidityUSD": 57638725
      },
      {
        "date": 1590105600,
        "totalLiquidityUSD": 56713126
      }
    ],
    "isParentProtocol": true,
    "raises": [
      {
        "date": 1594771200,
        "name": "Aave",
        "round": "Private token sale",
        "amount": 3,
        "chains": [
          "Ethereum",
          "Polygon",
          "Avalanche"
        ],
        "sector": "Aave is an open source non-custodial protocol on Ethereum for decentralized lending and borrowing.",
        "category": "DeFi",
        "categoryGroup": "DeFi & CeFi",
        "source": "",
        "leadInvestors": [
          "Framework Ventures",
          "3AC"
        ],
        "otherInvestors": [],
        "valuation": null,
        "defillamaId": "111"
      },
      {
        "date": 1602460800,
        "name": "Aave",
        "round": "Strategic ",
        "amount": 25,
        "chains": [
          "Ethereum",
          "Polygon",
          "Avalanche"
        ],
        "sector": "Aave is an open source non-custodial protocol on Ethereum for decentralized lending and borrowing.",
        "category": "DeFi",
        "categoryGroup": "DeFi & CeFi",
        "source": "",
        "leadInvestors": [
          "Blockchain Capital",
          "Blockchain.com Ventures",
          "Standard Crypto"
        ],
        "otherInvestors": [],
        "valuation": null,
        "defillamaId": "111"
      },
      {
        "date": 1594166400,
        "name": "Aave",
        "round": "Private token sale",
        "amount": 4.5,
        "chains": [
          "Ethereum",
          "Polygon",
          "Avalanche"
        ],
        "sector": "Aave is an open source non-custodial protocol on Ethereum for decentralized lending and borrowing.",
        "category": "DeFi",
        "categoryGroup": "DeFi & CeFi",
        "source": "",
        "leadInvestors": [
          "ParaFi Capital"
        ],
        "otherInvestors": [],
        "valuation": null,
        "defillamaId": "111"
      }
    ],
    "hacks": [
      {
        "date": 1773273600,
        "name": "Aave V3",
        "classification": "Ecosystem",
        "technique": "CAPO Oracle Misconfiguration",
        "amount": 862000,
        "chain": [
          "Ethereum"
        ],
        "bridgeHack": false,
        "targetType": "DeFi Protocol",
        "source": "",
        "returnedFunds": 862000,
        "defillamaId": "1599",
        "parentProtocolId": "parent#aave",
        "language": "Solidity"
      }
    ],
    "mcap": null
  },
  "h402": {
    "routeId": "crypto/defi-tvl",
    "provider": "blockrun-defillama",
    "selectedCandidateId": "crypto/defi-tvl/blockrun-defillama",
    "routing": "manual",
    "paidBy": "x402-exact"
  }
}

Providers

Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.

blockrun-defillama
x402
100
Success
100%
p50
4.98s
Calls
2
100%
$0.007$0.0050/call
Last successful call: 27d ago· Aggregated by h402 — not the source provider