{"uid":"cap_56R842BsZ7jORxAKRhIHz","slug":"dex-pair-discovery-uniswap-v2-v3-on-base-optimism-mainnet-e2aafe47","name":"DEX Pair Discovery (Uniswap V2/V3 on Base/Optimism/Mainnet)","description":"Pay-per-call on-chain API for AI agents and developers: wallet audits, token safety audits (honeypot detection), live gas prices, token prices, transaction receipts, balances, ENS resolution, block data, ERC-20 allowances, transaction simulation, swap quotes and multicall batches — all computed on-chain via public RPCs (no external market API). Pay per request in USDC on Base via the x402 exact scheme (EIP-3009 transferWithAuthorization). No API key, no signup, no subscription.","url":"https://x402-audit.tatschluizguilherme.workers.dev/pairs","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"count":10,"pairs":[{"quote":{"symbol":"WETH","address":"0x4200000000000000000000000000000000000006","decimals":18},"venue":"uniswap-v3","feePct":0.3,"token0":{"symbol":"WETH","address":"0x4200000000000000000000000000000000000006","decimals":18},"token1":{"symbol":"AERO","address":"0x940181a94a35a4569e4529a3cdfb74e38fd98631","decimals":18},"address":"0x3d5d143381916280ff91407febeb52f2b60f33cf","feeTier":3000,"priceUsd":0.4153275295,"liquidity":"778276117698…","liquidityUsd":4342823,"priceInQuote":0.000221597351,"sqrtPriceX96":"532227488789210…","quotePriceUsd":1874.1,"tokenIsToken0":false}],"token":{"symbol":"AERO","address":"0x940181a94a35a4569e4529a3cdfb74e38fd98631","decimals":18},"network":"base","truncated":true,"requestedAt":"2026-08-05T04:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3BuJfkeMduX3N6d4Jhicx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Discovers all Uniswap V2 and V3 liquidity pools for any ERC-20 token across Base, Optimism, and Ethereum Mainnet, returning per-pool pricing, liquidity, and reserve data computed directly on-chain.","exampleAgentPrompt":"Find all Uniswap V2 and V3 pools for the token at address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, and tell me which pool has the deepest liquidity and what the current USD price is.","exampleUseCases":[{"title":"Best swap route for DeFi token","prompt":"I want to swap some AERO tokens on Base — can you find all the Uniswap pools for AERO (0x940181a94A35A4569E4529A3CDfB74e38FD98631) on Base and tell me which pool has the highest liquidity and what the current price in USDC is?"},{"title":"On-chain price check before arbitrage","prompt":"Before I execute an arb, can you pull all Uniswap V2 and V3 pools for 0x4200000000000000000000000000000000000006 (WETH) on Optimism against USDC and USDT, and show me the spot price and liquidity for each pool sorted by depth?"},{"title":"DeFi token listing due diligence","prompt":"I'm researching a new ERC-20 at 0x6982508145454Ce325dDbE47a25d4ec3d2311933 on Ethereum Mainnet — can you find every Uniswap pool it's in, show me the fee tiers, USD liquidity, and current price so I can assess how tradeable it is?"}],"resultDescription":"Returns an array of pool objects sorted by liquidityUsd descending. Each object includes: venue (UniswapV2/V3), pool address, feeTier, feePct, token0 and token1 (symbol + decimals), tokenIsToken0 flag, quote token, priceInQuote, priceUsd, liquidityUsd, and either reserves (V2) or sqrtPriceX96+liquidity (V3). Also returns total pool count and a truncated flag. Pools with zero reserves are excluded.","failureModes":["Invalid or non-ERC-20 token address returns empty pool list or error","Unsupported chain value returns validation error","Token with no liquidity on any pool returns empty array","RPC timeout or on-chain call failure returns 5xx error","Malformed bases= parameter may result in no pools found"],"whenToPreferThis":"Use this endpoint when you need comprehensive, on-chain DEX liquidity discovery for an ERC-20 token without relying on any indexer or off-chain market data API. Ideal when you need to enumerate all available Uniswap V2/V3 fee tiers, compare liquidity depth across pools, or get a trustless spot price derived directly from contract state on Base, Optimism, or Ethereum Mainnet.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:40:34.280Z","isFirstParty":false}