{"uid":"cap_QzQ3M3mgVi1zItcaEk-sr","slug":"agent402-defi-chain-tvl-lookup-453f93f3","name":"Agent402 DeFi Chain TVL Lookup","description":"Blockchains ranked by DeFi total value locked with each chain's share of the total, native token, EVM chain id and CoinGecko id. Use it when an agent is comparing chains by DeFi activity or needs the canonical ids to query other services about a chain.","url":"https://agent402.tools/api/defi-chains","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"number","description":"Rows to return (default 25, max 100)."},"search":{"type":"string","description":"Chain name substring (case-insensitive)."},"minTvlUsd":{"type":"number","description":"Minimum chain TVL in USD."}}},"responseSchema":{"type":"json","example":{"count":1,"cached":false,"chains":[{"name":"Ethereum","rank":1,"tvlUsd":70000000000,"chainId":1,"geckoId":"ethereum","sharePct":58.3,"tokenSymbol":"ETH"}],"source":"defillama-chains","totals":{"chainCount":462,"totalTvlUsd":120000000000},"matched":462,"fetchedAt":"2026-08-22T12:00:00.000Z"}},"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_kVkfWJlvto5AzdDZbQVkB","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 ranked DeFi chain data including TVL, chain ID, token symbol, and market share, sourced from DeFiLlama, with optional filtering by name or minimum TVL.","exampleAgentPrompt":"Show me the top 10 DeFi blockchains by TVL — I want to see their chain IDs, market share percentages, and token symbols.","exampleUseCases":[{"title":"DeFi chain market share analysis","prompt":"Pull the top 25 DeFi chains by TVL and tell me what percentage of the total DeFi market each one controls — I'm trying to understand how concentrated liquidity is across chains."},{"title":"Filtering chains by minimum TVL","prompt":"Which DeFi chains currently have at least $5 billion in TVL? Give me their names, ranks, and token symbols."},{"title":"Searching for a specific chain's TVL","prompt":"Look up the current TVL and market share for Arbitrum — I want to know how it stacks up against other chains right now."}],"resultDescription":"Returns a JSON object with a list of DeFi chains sorted by rank, each containing name, TVL in USD, chain ID, CoinGecko ID, market share percentage, and token symbol. Also includes aggregate totals (total chain count and total TVL across all chains), a matched count, cache status, data source attribution, and a fetch timestamp.","failureModes":["No chains match the search substring — returns empty chains array with count 0","minTvlUsd set too high filters out all results — returns empty list","limit exceeds max of 100 — may be clamped or rejected","DeFiLlama upstream unavailable — may return stale cached data or error","Invalid input types (e.g. non-numeric minTvlUsd) — returns validation error"],"whenToPreferThis":"Use this endpoint when you need current, ranked DeFi chain TVL data with flexible filtering by name or minimum TVL threshold. Prefer this over general web search when you need structured, machine-readable chain metrics including chain IDs and CoinGecko IDs for downstream lookups. Ideal for agents doing DeFi portfolio analysis, chain comparison, or routing decisions based on liquidity depth.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:10:55.352Z","isFirstParty":false}