{"uid":"cap_ZwVh2CveQn4mXV883GwDk","slug":"agent402-defi-protocols-lookup-cdf1ea33","name":"Agent402 DeFi Protocols Lookup","description":"DeFi protocols ranked by total value locked, filterable by category, chain or name, each with rank, chains, TVL, 1h, 1d and 7d change, market cap and the market cap to TVL ratio. Use it when an agent needs the league table of protocols or wants to find the largest lending, DEX or staking venues on a chain.","url":"https://agent402.tools/api/defi-protocols","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string","description":"Chain filter as DefiLlama names it (Ethereum, Base, Solana, Arbitrum...). Rows are then ranked by TVL on that chain."},"limit":{"type":"number","description":"Rows to return (default 25, max 100)."},"search":{"type":"string","description":"Name/slug substring filter (case-insensitive)."},"category":{"type":"string","description":"Category filter (Lending, Dexs, Liquid Staking, Restaking, CDP, Yield, Derivatives, Bridge, RWA, CEX...). Case-insensitive exact match."},"minTvlUsd":{"type":"number","description":"Minimum TVL in USD."},"includeCex":{"type":"boolean","description":"Include centralized-exchange reserve rows (default false)."}}},"responseSchema":{"type":"json","example":{"count":1,"cached":true,"source":"defillama-protocols","filters":{"chain":null,"search":null,"category":"Lending","minTvlUsd":null,"includeCex":false},"matched":600,"fetchedAt":"2026-08-22T12:00:00.000Z","protocols":[{"name":"Aave V3","rank":3,"slug":"aave-v3","chains":["Ethereum","Base","Arbitrum"],"symbol":"AAVE","tvlUsd":17023522168,"mcapTvl":0.188,"mcapUsd":3200000000,"category":"Lending","chainCount":21,"change1dPct":0.8,"change1hPct":0.02,"change7dPct":2.4,"parentProtocol":"aave"}],"totalTvlUsd":48000000000}},"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_ikWDZiX2L9EkcnQcdKqXS","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 protocol data (TVL, market cap, chains, category) filtered by chain, category, TVL, or name, sourced from DefiLlama.","exampleAgentPrompt":"Show me the top 10 lending protocols on Ethereum ranked by TVL, with at least $500 million TVL each.","exampleUseCases":[{"title":"Top lending protocols by TVL","prompt":"What are the top 10 DeFi lending protocols on Ethereum right now, ranked by TVL? Only show ones with at least $1 billion in TVL."},{"title":"Discover Base chain DeFi ecosystem","prompt":"Give me a list of the top 25 DeFi protocols deployed on Base chain, across all categories, ranked by their TVL on Base."},{"title":"Find liquid staking options on Solana","prompt":"Which liquid staking protocols are available on Solana? Rank them by TVL and show me the top 10."}],"resultDescription":"A JSON object containing the count of returned protocols, total TVL, applied filters, fetch timestamp, and an array of protocol objects each with name, slug, rank, TVL in USD, mcap/TVL ratio, market cap, supported chains, category, chain count, and 1h/1d/7d TVL percentage changes.","failureModes":["Invalid chain name not recognized by DefiLlama returns empty or unfiltered results","Category string mismatch (case-sensitive expectations) may return zero results","Limit exceeding 100 is clamped or rejected","minTvlUsd filtering out all protocols returns empty array","Upstream DefiLlama data unavailability causes stale or error response","Malformed JSON body returns 400 error"],"whenToPreferThis":"Use this endpoint when you need live, ranked DeFi protocol data filtered by chain, category, or TVL threshold — especially when building DeFi dashboards, agent workflows that select protocols by criteria, or research tasks comparing protocol metrics. Prefer this over manual DefiLlama API calls when you want a pay-per-call, no-auth-key approach with structured filtering built in.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:47:11.652Z","isFirstParty":false}