{"uid":"cap_fVaKLWajVzFGAduVrrX7s","slug":"defillama-chain-tvl-lookup-x402-b12b3093","name":"DefiLlama Chain TVL Lookup (x402)","description":"Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.","url":"https://kr-x402-mvp.kgy5612.workers.dev/defillama/chain-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","examples":["Base","Ethereum"],"maxLength":40,"description":"Chain name, e.g. Base, Ethereum, Solana"},"limit":{"type":"integer","maximum":50,"minimum":1,"description":"Top chains to list (default 15)"},"protocol":{"type":"string","examples":["aave"],"maxLength":60,"description":"DefiLlama protocol slug, e.g. aave, lido, aerodrome"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"defi":{"base":{"rank":5,"tvl_usd":3900000000,"share_pct":3.1},"flow":"flat","change_1d_pct":0.3,"change_7d_pct":-2.1,"total_tvl_usd":125000000000,"chains_counted":300,"change_30d_pct":4},"next":["/crypto/global-market","/crypto/stablecoin-peg"],"chain":{"flow":"flat","name":"Base","rank":5,"as_of":"2026-10-30","tvl_usd":3900000000,"chain_id":8453,"change_1d_pct":0.4,"change_7d_pct":-1.2,"change_30d_pct":5.6,"share_of_defi_pct":3.1},"signal":"NEUTRAL","source":"https://defillama.com","reasons":["DeFi TVL $125.0B, 7d -2.1%","Base #5 $3.90B, 7d -1.2% (flat)"],"top_chains":[{"name":"Ethereum","rank":1,"token":"ETH","tvl_usd":70000000000,"share_pct":56}],"updated_at":"2026-10-30T02:30:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_69pyzoN25xsligLyRCvcY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time TVL (Total Value Locked) data for a specific blockchain or across all DeFi chains, with rankings, flow signals, and change metrics, paid via x402 micropayment.","exampleAgentPrompt":"What's Base's current TVL, its rank among all chains, and how has it changed over the past week?","exampleUseCases":[{"title":"Chain TVL health check for trading bot","prompt":"Pull the current TVL for Ethereum, its rank, and whether TVL is flowing in or out over the last 7 days — I want to decide if conditions are favorable for a DeFi trade."},{"title":"Top chains leaderboard snapshot","prompt":"Give me a leaderboard of the top 15 blockchains by TVL right now, including their share of total DeFi and their 7-day change."},{"title":"DeFi market sentiment gauge","prompt":"What's the total DeFi TVL across all chains today, and what's the 30-day trend? I want to know if the overall market is growing or contracting."}],"resultDescription":"Returns a JSON object with chain-level TVL in USD, rank, share of total DeFi, 1d/7d/30d percentage changes, flow direction (flat/inflow/outflow), a NEUTRAL/BULLISH/BEARISH signal, global DeFi totals, a ranked list of top chains, and a timestamp. Also includes suggested next endpoints.","failureModes":["Unknown chain name returns empty or error response","Limit parameter exceeding 50 returns validation error","Stale data if DefiLlama upstream is delayed","x402 payment failure if wallet has insufficient USDC on Base","Invalid protocol slug returns no protocol-specific data"],"whenToPreferThis":"Choose this endpoint when an AI agent needs real-time DeFi TVL data for one or more blockchains without managing API keys, paid via USDC micropayment on Base. Ideal for trading agents, onchain analytics bots, or any workflow needing authoritative chain TVL rankings and trend signals from DefiLlama.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:55.372Z","isFirstParty":false,"canonicalSlug":"defillama-chain-tvl-lookup-x402-b12b3093"}