{"uid":"cap_E_U2m75HOTTPb86x9LFOI","slug":"defi-tvl-lookup-chain-protocol-x402-1913e75e","name":"DeFi TVL Lookup – Chain & Protocol (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/v1/crypto/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_rcVVxci4Hw0yY3vhkUKQj","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 total DeFi TVL, per-chain TVL stats, and optional protocol-level TVL with 1d/7d/30d changes and a directional signal, paid per-call via x402 USDC on Base.","exampleAgentPrompt":"What's the current TVL for Base chain — its rank, share of total DeFi, and how it's changed over the past 7 days — and is the overall DeFi trend bullish or neutral right now?","exampleUseCases":[{"title":"DeFi market health check","prompt":"Give me a snapshot of total DeFi TVL right now, including the 1-day and 7-day change and whether the trend looks bullish or bearish."},{"title":"Chain TVL comparison for Base","prompt":"What's Base chain's current TVL, its rank among all chains, and its share of total DeFi? Show me the top 10 chains while you're at it."},{"title":"Protocol TVL lookup for Aave","prompt":"What's the TVL for the Aave protocol on Ethereum right now, and how has it changed over the past week?"}],"resultDescription":"Returns total DeFi TVL in USD, per-chain TVL with rank, share percentage, and 1d/7d/30d change percentages, a directional flow signal (bullish/neutral/bearish), list of top chains, source attribution, and suggested next endpoints. Optionally scoped to a specific chain or protocol slug.","failureModes":["Invalid chain name returns error or empty chain object","Protocol slug not found returns missing protocol data","Upstream DefiLlama API outage causes stale or missing data","limit parameter out of range (1-50) returns validation error","Payment failure via x402 returns 402 with payment requirements"],"whenToPreferThis":"Prefer this endpoint when an AI agent needs DeFi TVL data — total market, per-chain, or per-protocol — in a single pay-per-call call with no API key setup. It combines total DeFi TVL and chain-level detail in one response (competitors often split these into two separate calls at higher cost). Best for trading agents, onchain strategy bots, and portfolio monitors that need fresh TVL context on demand without committing to a subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:01.535Z","isFirstParty":false,"canonicalSlug":"defi-tvl-lookup-chain-protocol-x402-fd5ca1fe"}