{"uid":"cap_Aml_rFrYceuMlswWyqtNK","slug":"dex-top-pools-by-tvl-a32d5879","name":"DEX Top Pools by TVL","description":"Top DEX pools (Uniswap, Sushi, Curve, Aerodrome, etc.) ranked by current TVL - filterable by chain and project. Sourced from DeFiLlama's public Yields API (keyless). Each row carries chain, project slug, symbol pair, TVL in USD, current APY, and pool ID for follow-up queries.","url":"https://agent402.tools/api/dex-top-pools","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string","description":"Chain name as DeFiLlama uses it (Ethereum, Base, Polygon, Arbitrum, Optimism, etc.). Case-insensitive. Omit for all chains."},"limit":{"type":"number","description":"Max pools to return (1-50, default 10)."},"project":{"type":"string","description":"Project slug substring (uniswap-v3, aerodrome-v1, curve-dex, etc.). Case-insensitive substring match. Omit for all DEXes."}}},"responseSchema":{"type":"json","example":{"chain":"Base","count":5,"pools":[{"apy":12.3,"pool":"abc123","chain":"Base","symbol":"WETH-USDC","tvlUsd":45000000,"project":"uniswap-v3"}],"source":"defillama-yields","project":"uniswap-v3"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Q-Hqajnpeg4NIwOO3k1kH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top decentralized exchange liquidity pools ranked by current TVL, filterable by chain and project, with APY and pool metadata sourced from DeFiLlama.","exampleAgentPrompt":"Show me the top 15 DEX liquidity pools on Arbitrum right now, ranked by TVL — include APY and which project each pool belongs to.","exampleUseCases":null,"resultDescription":"A ranked list of up to 50 DEX pools including chain name, project slug, token symbol pair, TVL in USD, and current APY percentage — sourced live from DeFiLlama's yields data.","failureModes":["Invalid chain name returns empty results or error","limit out of range (>50 or <1) may return default or error","project slug substring with no matches returns empty array","DeFiLlama upstream API unavailability causes failure","Malformed request body returns 400-level error"],"whenToPreferThis":"Use this endpoint when you need a ranked, filterable snapshot of DEX pool TVL and APY across major chains and protocols without needing a DeFiLlama API key. Prefer it over manual scraping or authenticated APIs for quick DeFi liquidity research.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:05:53.639Z","isFirstParty":false}