{"uid":"cap_Zoq5_pO5dN-Ve7l-Nzyi5","slug":"mangrove-defi-chain-tvl-lookup-1ab8f3bc","name":"Mangrove DeFi Chain TVL Lookup","description":"Developer references for Mangrove Agent, API contracts, MCP and AI integrations.","url":"https://api.mangrovedeveloper.ai/api/v1/defi/chain/%7Bchain%7D/tvl?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"chain":"Base","found":true,"tvl_usd":6137363525},"chain":"Base","success":true,"tvl_usd":6137363525,"provider":"defillama","top_protocols":[{"tvl":172625913137,"name":"Binance CEX","category":"CEX"},{"tvl":30743144868,"name":"OKX","category":"CEX"},{"tvl":16875767295,"name":"Aave V3","category":"Lending"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_d9RChJgDFn4ShSUPEY01R","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the total value locked (TVL) in USD for a specified blockchain, along with top protocols by TVL, sourced from DeFiLlama.","exampleAgentPrompt":"What's the current total value locked on Base, and which protocols are leading by TVL?","exampleUseCases":[{"title":"DeFi market size research","prompt":"Can you tell me the total value locked on Arbitrum right now and show me the top protocols by TVL?"},{"title":"Chain comparison for yield strategy","prompt":"I'm deciding where to deploy liquidity — what's the TVL on Optimism, and which lending or DEX protocols dominate there?"},{"title":"Monitoring DeFi ecosystem growth","prompt":"Pull the latest TVL data for the Ethereum chain so I can track how the DeFi ecosystem is growing this month."}],"resultDescription":"A JSON object containing the chain name, total TVL in USD, a boolean success flag, the data provider (DeFiLlama), and a list of top protocols with their individual TVL values and categories (e.g. Lending, CEX, DEX).","failureModes":["Unsupported or misspelled chain name returns an error or found:false","Chain with no indexed data may return TVL of 0 or empty protocol list","DeFiLlama upstream outage may cause stale or unavailable data","Malformed chain path parameter returns a 400 or 404 error"],"whenToPreferThis":"Use this endpoint when you need on-chain TVL data for a specific blockchain, especially when you also want a breakdown of top protocols. Prefer this over manually querying DeFiLlama directly when you need a simple, pay-per-call API compatible with x402 payment flows in an agent context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:32:46.748Z","isFirstParty":false,"canonicalSlug":"mangrove-defi-chain-tvl-lookup-1ab8f3bc"}