{"uid":"cap_sam4txpu6ygjaPpiEAOoB","slug":"defi-protocol-tvl-lookup-via-defillama-b15b4ad4","name":"DeFi Protocol TVL Lookup via DeFiLlama","description":"Look up the current Total Value Locked (TVL) for a DeFi protocol via DeFiLlama's public API. Identify the protocol by its DeFiLlama slug (uniswap, aave, lido, ethena, etc.). Returns the total TVL plus per-chain breakdown and 24h/7d/30d change where DeFiLlama exposes it.","url":"https://agent402.tools/api/defi-tvl","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"protocol":{"type":"string","description":"DeFiLlama protocol slug (e.g. uniswap, aave, lido). Lowercase, hyphen-separated."}}},"responseSchema":{"type":"json","example":{"name":"AAVE","tvlUsd":15000000000,"category":"Lending","change7d":2.1,"protocol":"aave","chainTvls":[{"chain":"Ethereum","tvlUsd":11000000000}],"change24h":0.5,"change30d":8}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DDo2pXhs1fcwO5J-zhIkd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current Total Value Locked (TVL) for a DeFi protocol by its DeFiLlama slug, including per-chain breakdown and 24h/7d/30d change metrics.","exampleAgentPrompt":"What's the current TVL for Lido across all chains, and how has it changed over the past 7 days?","exampleUseCases":null,"resultDescription":"Returns the total TVL in USD for the specified DeFi protocol, a breakdown of TVL per blockchain (e.g. Ethereum, Arbitrum, Polygon), and percentage or absolute changes over 24h, 7d, and 30d periods.","failureModes":["Unknown or misspelled protocol slug returns an error or empty result","Protocol not indexed by DeFiLlama returns no data","API rate limiting or upstream DeFiLlama outage causes timeout","Missing required 'protocol' field in request body causes validation error"],"whenToPreferThis":"Use this endpoint when you need current TVL data for a specific DeFi protocol by its DeFiLlama slug, especially when you want per-chain breakdowns and recent trend data. Prefer this over general financial data APIs when the protocol is indexed by DeFiLlama and you need DeFi-specific liquidity metrics rather than price or volume data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:07:37.211Z","isFirstParty":false}