{"uid":"cap_gtYmsysyb1o4yO6F71eek","slug":"tokenguard-tvl-endpoint-42d91db3","name":"TokenGuard TVL Endpoint","description":"Protocol TVL ranking + 1d/7d momentum, filterable by category/chain (DeFi analytics).","url":"https://eltociear-tokenguard.hf.space/tvl","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string","description":"Chain filter (optional)"},"category":{"type":"string","description":"Category filter e.g. Lending/DEX (optional)"}}},"responseSchema":{"type":"json","example":{"count":20,"protocols":[{"name":"Aave","tvl_usd":15000000000,"category":"Lending","change_1d_pct":1.2}]}},"example":{"request":{"input":{"body":{"chain":"ethereum","category":"Lending"},"type":"http","method":"POST","bodyType":"json"}},"response":{"count":20,"filter":{"chain":"ethereum","category":"Lending"},"source":"DefiLlama","summary":"#1 Aave V3 (Lending) $12,607,352,702 TVL, 1d 0.91%.","protocols":[{"name":"Aave V3","chains":["Ethereum","Plasma","Arbitrum","Base","Avalanche"],"tvl_usd":12607352702,"category":"Lending","change_1d_pct":0.91,"change_7d_pct":7.4},{"name":"Morpho Blue","chains":["Ethereum","Base","Hyperliquid L1","Monad","Katana"],"tvl_usd":7096172536,"category":"Lending","change_1d_pct":0.94,"change_7d_pct":10.21},{"name":"SparkLend","chains":["Ethereum","xDai"],"tvl_usd":3450818864,"category":"Lending","change_1d_pct":-1.82,"change_7d_pct":4.47},{"name":"Maple","chains":["Ethereum","Solana"],"tvl_usd":2205362051,"category":"Lending","change_1d_pct":3.64,"change_7d_pct":11.86},{"name":"Compound V3","chains":["Ethereum","Arbitrum","Base","Optimism","Polygon"],"tvl_usd":1099198008,"category":"Lending","change_1d_pct":-1.24,"change_7d_pct":8.22},{"name":"Venus Core Pool","chains":["Binance","Ethereum","Arbitrum","zkSync Era","Base"],"tvl_usd":1068596785,"category":"Lending","change_1d_pct":-2.06,"change_7d_pct":4.85},{"name":"Lista Lending","chains":["Binance","Ethereum"],"tvl_usd":647429297,"category":"Lending","change_1d_pct":-2.8,"change_7d_pct":5.61},{"name":"Fluid Lending","chains":["Ethereum","Arbitrum","Plasma","Base","Polygon"],"tvl_usd":592750385,"category":"Lending","change_1d_pct":-0.94,"change_7d_pct":0.75},{"name":"Aave Horizon RWA","chains":["Ethereum"],"tvl_usd":296278041,"category":"RWA Lending","change_1d_pct":-1.44,"change_7d_pct":0},{"name":"Euler V2","chains":["Ethereum","Monad","Plasma","Base","Avalanche"],"tvl_usd":270338845,"category":"Lending","change_1d_pct":-1.03,"change_7d_pct":1.73},{"name":"cap","chains":["Ethereum"],"tvl_usd":256911218,"category":"Lending","change_1d_pct":-1,"change_7d_pct":5.93},{"name":"Cooler Loans","chains":["Ethereum"],"tvl_usd":185016087,"category":"Lending","change_1d_pct":-2.87,"change_7d_pct":-4.97},{"name":"Pareto Credit","chains":["Ethereum","Polygon","Arbitrum","Optimism"],"tvl_usd":183850724,"category":"RWA Lending","change_1d_pct":0.58,"change_7d_pct":1.65},{"name":"Dolomite","chains":["Ethereum","Berachain","Arbitrum","Mantle","Polygon zkEVM"],"tvl_usd":169417063,"category":"Lending","change_1d_pct":38.77,"change_7d_pct":34.43},{"name":"Aave V4","chains":["Ethereum"],"tvl_usd":129312329,"category":"Lending","change_1d_pct":-0.88,"change_7d_pct":22.68},{"name":"Aave V2","chains":["Ethereum","Polygon","Avalanche"],"tvl_usd":110455219,"category":"Lending","change_1d_pct":-1.63,"change_7d_pct":4.46},{"name":"Compound V2","chains":["Ethereum"],"tvl_usd":93537147,"category":"Lending","change_1d_pct":-2.1,"change_7d_pct":5.63},{"name":"Curve LlamaLend","chains":["Ethereum","Arbitrum","Fraxtal","Optimism"],"tvl_usd":64172445,"category":"Lending","change_1d_pct":-1.33,"change_7d_pct":1.08},{"name":"Flux Finance","chains":["Ethereum"],"tvl_usd":44007236,"category":"Lending","change_1d_pct":0.02,"change_7d_pct":0.06},{"name":"TermMax","chains":["Ethereum","Base","Binance","Berachain","X Layer"],"tvl_usd":37208419,"category":"Lending","change_1d_pct":-0.06,"change_7d_pct":-0.52}]}},"exampleRequest":{"chain":"ethereum","category":"Lending"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KUJEXbx8NhrRtDZnUfzmu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches Total Value Locked (TVL) data for DeFi protocols, filterable by blockchain and category, sourced from DefiLlama","exampleAgentPrompt":"Show me the top lending protocols by TVL on Ethereum right now — I want to see their names, TVL in USD, and how much they've changed in the last day and week.","exampleUseCases":null,"resultDescription":"Returns a ranked list of DeFi protocols with their TVL in USD, supported chains, category classification, and 1-day and 7-day percentage change in TVL, along with a total count of matching protocols and the data source (DefiLlama).","failureModes":["Invalid or unsupported chain name returns empty or error response","Invalid category string returns zero results","Payment failure via x402 results in 402 response blocking the call","DefiLlama upstream data unavailable causes timeout or stale data","Malformed JSON body returns 400 bad request"],"whenToPreferThis":"Use this endpoint when you need ranked TVL data for DeFi protocols filtered by chain or category, especially when you want DefiLlama-sourced data with recent percentage changes. Prefer this over generic crypto price APIs when the question is about protocol-level liquidity or DeFi ecosystem size.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:55:03.636Z","isFirstParty":false}