{"uid":"cap_Vrv2BXcFl1SWzrMCuavPt","slug":"x402-defi-protocol-tvl-b2abcb42","name":"x402 DeFi Protocol TVL","description":"Look up a DeFi protocol's current total value locked (TVL), by chain, plus market cap","url":"https://agentx402pay.com/api/defi-tvl?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["protocol"],"properties":{"protocol":{"type":"string","description":"DefiLlama protocol slug, e.g. \"uniswap\", \"aave\""}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_spWV5XEGkxxeoBu2Ut1Tq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a DeFi protocol's current total value locked (TVL) broken down by chain, plus market cap data, via a micropayment-gated API","exampleAgentPrompt":"What's Uniswap's current total value locked, broken down by chain, and what's its market cap?","exampleUseCases":[{"title":"DeFi protocol health check","prompt":"Can you pull the current TVL for Aave across all chains and tell me what its market cap is right now?"},{"title":"Chain-specific liquidity research","prompt":"How much total value is locked in Curve Finance, and which blockchains have the most liquidity?"},{"title":"Portfolio protocol due diligence","prompt":"I'm evaluating Lido as a staking protocol — what's its current TVL broken down by chain and what's the market cap?"}],"resultDescription":"Returns the protocol's current total value locked (TVL) as an aggregate figure and broken down per chain, along with market cap data. Data is sourced from DefiLlama and reflects near-real-time on-chain state.","failureModes":["Invalid or unrecognized protocol slug returns an error or empty result","Protocol exists but has no indexed TVL data","Rate limiting or payment verification failure returns 402 or 429","Temporary DefiLlama upstream outage causes stale or missing data"],"whenToPreferThis":"Use this endpoint when you need current TVL and market cap for a specific DeFi protocol, especially when you need chain-level breakdown. It is ideal for agents performing DeFi research, portfolio analysis, or protocol due diligence. Prefer this over general crypto price APIs when TVL (not just price) is the metric of interest.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T12:32:46.252Z","isFirstParty":false,"canonicalSlug":"x402-defi-protocol-tvl-b2abcb42"}