{"uid":"cap_P-t_c5V0D81J2cqq57O9r","slug":"defillama-tvl-chain-analytics-via-x402-60b77868","name":"DefiLlama TVL & Chain Analytics via 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/crypto/defillama?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_nZuLXIgN49bxsX2rRmiye","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 DefiLlama-sourced DeFi TVL data for global markets, specific chains, and protocols — including rankings, flow signals, and percentage changes — paid per-call with USDC on Base via x402.","exampleAgentPrompt":"Pull the current DefiLlama TVL breakdown for Base — I want the chain rank, 7-day change, and flow signal so I can decide whether to deploy capital there.","exampleUseCases":[{"title":"Monitor Base DeFi TVL for capital deployment","prompt":"Check the current TVL and flow signal for Base chain — is DeFi activity there growing, flat, or declining over the last 7 days?"},{"title":"Compare top chains by TVL for portfolio rebalancing","prompt":"Give me the top 15 chains ranked by TVL with their 7-day and 30-day changes so I can figure out where DeFi liquidity is migrating."},{"title":"Track Aave protocol TVL for yield strategy","prompt":"What's Aave's current TVL on DefiLlama and how has it changed over the last week? I'm deciding whether to add liquidity."}],"resultDescription":"Returns a JSON object with global DeFi TVL, the queried chain's rank/TVL/flow/changes, per-protocol TVL if requested, a top-chains leaderboard, a directional signal (BULLISH/NEUTRAL/BEARISH), human-readable reasons, and suggested next endpoints to call.","failureModes":["Unknown chain name returns empty or error — use exact DefiLlama chain slugs like 'Base' or 'Ethereum'","Unknown protocol slug returns null protocol data","Payment failure (insufficient USDC on Base) returns HTTP 402 and no data","Stale data if DefiLlama upstream is delayed — check updated_at timestamp","Limit out of range (>50 or <1) rejected by schema validation"],"whenToPreferThis":"Use this endpoint when an AI agent needs real-time DeFi TVL signals for a specific chain or protocol without managing API keys, and is already operating with USDC on Base for x402 micropayments. Prefer over direct DefiLlama API calls when you need pre-interpreted flow signals and trading-ready summaries rather than raw data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:19.360Z","isFirstParty":false,"canonicalSlug":"defillama-tvl-chain-analytics-via-x402-60b77868"}