{"uid":"cap_2z4GfFMAxF0qEgFPNtnWa","slug":"crypto-openverbs-com-tvl-lookup-f78b76a8","name":"crypto.openverbs.com TVL Lookup","description":"Total value locked (USD) for a DeFi protocol (e.g. \"aave\") or a whole chain (e.g. \"Ethereum\"). Provide exactly one of `protocol` or `chain`.","url":"https://crypto.openverbs.com/v1/tvl","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":[],"properties":{"chain":{"type":"string","maxLength":100,"minLength":1,"description":"Chain name, e.g. \"Ethereum\", \"Arbitrum\", \"Solana\"."},"protocol":{"type":"string","maxLength":100,"minLength":1,"description":"Protocol slug, e.g. \"aave\", \"uniswap\", \"lido\"."}},"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":{"type":"json","example":{"kind":"protocol","name":"aave-v3","found":true,"stale":false,"source":"defillama","tvlUsd":17459433934.27}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1-K90W7-VlFqMhA7CHnSB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","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 (USD) for a specific DeFi protocol (e.g. Aave) or an entire blockchain (e.g. Ethereum)","exampleAgentPrompt":"What's the current total value locked for Aave? I want the USD TVL figure right now.","exampleUseCases":[{"title":"Protocol due diligence before investing","prompt":"I'm considering putting money into Lido — can you pull the current TVL for the Lido protocol so I can see how much capital is backing it?"},{"title":"Chain-level DeFi health check","prompt":"How much value is locked across all DeFi protocols on Arbitrum right now? Give me the total TVL for the Arbitrum chain in USD."},{"title":"Comparing protocol sizes","prompt":"I want to compare Aave and Uniswap by size — can you look up the current TVL for Aave first so I can benchmark it?"}],"resultDescription":"A USD total value locked figure for the requested protocol slug (e.g. 'aave', 'uniswap') or chain name (e.g. 'Ethereum', 'Solana'), returned as a numeric value representing current on-chain deposits.","failureModes":["Unknown protocol slug returns an error or zero TVL — use exact DeFiLlama slugs like 'aave' not 'AAVE'","Providing both protocol and chain simultaneously is rejected — only one is allowed","Unrecognized chain name returns an error — use canonical names like 'Ethereum' not 'ETH'","Network timeouts if upstream DeFiLlama data source is slow or unavailable","Payment failure if x402 micropayment of $0.001 USDC is not included"],"whenToPreferThis":"Use this endpoint when you need TVL for a single specific protocol or chain by name. Prefer it over the DeFi market overview endpoint when you want targeted data for one entity rather than a global summary. Ideal for due diligence, protocol comparison, or monitoring a specific protocol's health over time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:31:39.058Z","isFirstParty":false}