{"uid":"cap_341B3XSt7VDULE89PS4Y1","slug":"protocol-tvl-live-single-number-f49d33dc","name":"Protocol TVL (Live Single Number)","description":"Current total TVL for named protocols, one number each — the cheap poll (avoids the 10MB per-protocol history blob). Query: protocol — comma list of DefiLlama slugs (up to 20), e.g. aave,uniswap-v3. null means an unknown slug.","url":"https://x402.shizu.me/llama/tvl","method":"GET","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["method"],"properties":{"method":{"const":"GET"},"queryParams":{"type":"object","required":["protocol"],"properties":{"protocol":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"source":"defillama","tvl_usd":{"aave":14400000000,"uniswap":3100000000}}},"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_dsbOtMmE184WFn1lbxKlo","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 (TVL) for up to 20 named DeFi protocols as a single number each, using DefiLlama slugs.","exampleAgentPrompt":"What's the current TVL for aave, uniswap-v3, and curve right now — just the live numbers, not the full history?","exampleUseCases":[{"title":"DeFi protocol health dashboard","prompt":"Can you pull the current TVL for aave, compound, and makerdao so I can see how healthy those lending protocols are right now?"},{"title":"Comparing rival DEX liquidity","prompt":"What's the live TVL for uniswap-v3, curve, and balancer? I want to see which DEX has the most locked liquidity today."},{"title":"Alert on TVL drop for a protocol","prompt":"Check the current TVL for lido and aave — I want to know if either has dropped significantly compared to what I last saw."}],"resultDescription":"Returns a JSON object mapping each requested protocol slug to its current TVL as a single USD number. Unknown or invalid slugs return null. Up to 20 protocols can be queried per call.","failureModes":["Unknown or misspelled protocol slug returns null for that entry","More than 20 slugs in the query may be rejected or truncated","Payment of $0.003 USDC required per call; unpaid requests return 402","Temporary DefiLlama data unavailability may yield stale or missing values"],"whenToPreferThis":"Use this endpoint when you need the current TVL for one or more DeFi protocols as a lightweight single-number lookup. Prefer this over a full protocol history endpoint when you only need the latest value and want to avoid fetching large historical blobs. Ideal for dashboards, alerts, or comparisons across up to 20 protocols in a single cheap call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:52:25.779Z","isFirstParty":false}