{"uid":"cap_ffJNbggzde8ii4grBgy73","slug":"tbs-crypto-defi-api-defi-tvl-lookup-6134f3d1","name":"TBS Crypto & DeFi API – DeFi TVL Lookup","description":"DeFi TVL (total value locked) for AI agents. Query a single protocol by slug (aave, uniswap, lido) for its current USD TVL, a specific chain by name, or omit both for the top 20 chains ranked by TVL. Sourced from DefiLlama — on-chain liquidity and DeFi health signal in USD.","url":"https://x402.tbs-digital.com/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","properties":{"chain":{"type":"string","description":"Chain name, e.g. Ethereum (optional)"},"protocol":{"type":"string","description":"DefiLlama protocol slug, e.g. aave (optional)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"chain":{"type":"object","nullable":true},"payer":{"type":"object","properties":{"address":{"type":"string","nullable":true},"network":{"type":"string"}}},"source":{"type":"string"},"protocol":{"type":"object","nullable":true},"request_id":{"type":"string"},"top_chains":{"type":"array"},"generated_at":{"type":"string"}}}}}}},"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_Zy-mWSeIneVm4oOzM9PVs","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 current USD total value locked (TVL) for a specific DeFi protocol, a specific chain, or the top 20 chains ranked by TVL, sourced from DefiLlama.","exampleAgentPrompt":"What's the current TVL of Aave right now? Pull it from DefiLlama so I have the latest on-chain liquidity figure.","exampleUseCases":[{"title":"Protocol health check before investment","prompt":"What's the current total value locked in Lido? I want to see how much liquidity is sitting there before I make a decision."},{"title":"Chain TVL competitive analysis","prompt":"Pull the TVL for Ethereum right now — I want to compare it against other chains to see where DeFi liquidity is concentrated."},{"title":"Top DeFi chains dashboard","prompt":"Give me the top 20 blockchains ranked by DeFi TVL right now so I can see the current state of the whole ecosystem."}],"resultDescription":"Returns a JSON object containing the current USD TVL for the requested protocol (e.g. {protocol: {slug, tvl, chains}}), the requested chain (e.g. {chain: {name, tvl}}), or an array of the top 20 chains ranked by TVL (top_chains), along with metadata including a request ID, data source attribution (DefiLlama), and a generated_at timestamp.","failureModes":["Unknown protocol slug returns null or empty protocol object","Unknown or misspelled chain name returns null chain result","DefiLlama upstream outage may cause stale or unavailable data","Missing query params defaults to top 20 chains — may be unexpected if user intended a specific lookup","Payment failure (402) if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need current on-chain DeFi TVL data for protocols or chains, sourced from DefiLlama. It is ideal for DeFi health monitoring, liquidity analysis, protocol comparison, or ecosystem-level chain ranking. Prefer it over general crypto price endpoints when the question is about locked liquidity rather than spot price or market cap.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:49:38.294Z","isFirstParty":false,"canonicalSlug":"tbs-crypto-defi-api-defi-tvl-lookup-6134f3d1"}