{"uid":"cap_A48z9lIKnPrjOcEZ4_lkb","slug":"tbs-crypto-defi-api-defi-tvl-lookup-e92386e5","name":"TBS Crypto & DeFi API – DeFi TVL Lookup","description":"Crypto & DeFi data for AI agents in one sub-cent call: real-time token prices, market data (market cap, volume, supply), DeFi TVL by protocol or chain, yield/APY pools, and a flagship bundle combining all of it. DefiLlama + Coinpaprika, keyless, unified schema, USDC-payable via x402 on Base.","url":"https://crypto-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":{"type":"json","example":{"payer":{"address":"0x0000000000000000000000000000000000000000","network":"base"},"source":"defillama","request_id":"0b21c0e6-6a3f-4e2a-8b1e-2f9d4c7a1e55","top_chains":[{"name":"Ethereum","tvl_usd":52100000000}],"generated_at":"2026-08-11T12:00:00.000Z"}},"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_USAfbY2dOkgR-OssY_Ciu","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 real-time Total Value Locked (TVL) data for DeFi protocols and chains, sourced from DefiLlama, filterable by chain or protocol slug.","exampleAgentPrompt":"Can you pull the current total value locked for Aave from DefiLlama? I want to see how much is locked in that protocol right now.","exampleUseCases":[{"title":"Monitor protocol TVL for investment research","prompt":"What's the current TVL for the Uniswap protocol on DefiLlama? I'm evaluating how much liquidity it holds before making a DeFi investment decision."},{"title":"Compare DeFi activity across chains","prompt":"Can you get me the top DeFi chains by TVL right now? I want to see which blockchains have the most value locked in them."},{"title":"Track Arbitrum DeFi ecosystem size","prompt":"What's the total value locked on the Arbitrum chain in DeFi? I'm trying to gauge how big the ecosystem is compared to Ethereum."}],"resultDescription":"Returns a JSON object containing a list of top chains with their TVL in USD, optionally filtered to a specific chain or DefiLlama protocol slug. Also includes the data source (DefiLlama), a request ID, payer address, network, and a generated timestamp.","failureModes":["Invalid protocol slug returns null or empty protocol object","Unknown chain name returns null chain data","Missing required method field causes request rejection","Network latency from upstream DefiLlama data feed may cause stale data","USDC payment failure via x402 on Base blocks the request"],"whenToPreferThis":"Choose this endpoint when you need real-time DeFi TVL data specifically from DefiLlama for a given protocol or chain, payable via USDC on Base with no API key required. Prefer it over direct DefiLlama API calls when you need a unified, agent-ready schema with x402 micropayment support and sub-cent pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:37:28.282Z","isFirstParty":false,"canonicalSlug":"tbs-crypto-defi-api-defi-tvl-lookup-e92386e5"}