{"uid":"cap_F6Yf5YlYIthHv6L9dD7D-","slug":"defi-protocol-tvl-lookup-1d428b0e","name":"DeFi Protocol TVL Lookup","description":"Total value locked (USD) for one DeFi protocol by DefiLlama slug or name (e.g. \"aave-v3\", \"lido\", \"uniswap-v3\"): current TVL, per-chain TVL breakdown, 1h/1d/7d TVL change, category, chains, token symbol and market cap. Optional `chain` also returns that chain's TVL for the protocol. Unknown names return `found:false` with slug `suggestions`.","url":"https://crypto.openverbs.com/v1/protocol","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["protocol"],"properties":{"chain":{"type":"string","maxLength":50,"minLength":1,"description":"Optional chain to also report the protocol's TVL on, e.g. \"Ethereum\", \"Base\", \"Arbitrum\"."},"protocol":{"type":"string","maxLength":80,"minLength":1,"description":"DefiLlama protocol slug or exact name, e.g. \"aave-v3\", \"lido\", \"uniswap-v3\", \"Curve Finance\"."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_dS2T3alxVKUL7t7x0uisU","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 total value locked (USD) for a single DeFi protocol by DefiLlama slug or name, including per-chain TVL breakdown and 1h/1d/7d changes","exampleAgentPrompt":"What's the current TVL for Aave v3, and how has it changed over the past 7 days? Also break it down by chain if you can.","exampleUseCases":[{"title":"Monitor Lido TVL shift","prompt":"Check Lido's total value locked right now and tell me the 1-day and 7-day TVL change — I want to know if there's been significant movement."},{"title":"Chain-specific protocol TVL","prompt":"What is Aave v3's TVL specifically on Arbitrum? Give me both the protocol's total TVL and how much of it is on that chain."},{"title":"Research DeFi protocol stats","prompt":"I'm comparing Uniswap v3 and Curve Finance — can you pull up each protocol's current TVL, their category, and which chains they're deployed on?"}],"resultDescription":"Returns a JSON object containing the protocol's current total TVL in USD, a per-chain TVL breakdown, percentage changes over 1h/1d/7d periods, the protocol's category (e.g. DEX, Lending), list of chains it operates on, associated token symbol, and market cap. If an optional chain is provided, also returns that chain's specific TVL for the protocol. If the protocol name is unknown, returns found:false along with slug suggestions.","failureModes":["Unknown protocol name returns found:false with slug suggestions instead of TVL data","Misspelled or ambiguous protocol names may return suggestions rather than exact matches","Chain parameter not matching an active chain for the protocol may return null or missing chain TVL","DefiLlama data may have brief delays for very recent TVL changes","Rate limiting or payment failures may prevent successful API calls"],"whenToPreferThis":"Use this endpoint when you need detailed TVL data for a specific DeFi protocol — including per-chain breakdowns and recent TVL momentum (1h/1d/7d change). Prefer this over the ranked list endpoint when you already know the protocol name and need precise, single-protocol data. Ideal for monitoring TVL changes for a known protocol, or enriching research on a specific DeFi project with on-chain capital data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:30:14.576Z","isFirstParty":false}