{"uid":"cap_TWarKhKrBovq6Ejf-y8XR","slug":"uniswap-v3-pool-search-by-token-06536b91","name":"Uniswap V3 Pool Search by Token","description":"Uniswap V3 pools on Ethereum that contain a given token, by token contract address, ranked by total value locked, each with pair, fee tier and TVL, from a subgraph behind an API key. For finding where a token has liquidity. find pools, token liquidity pools, pools for token, where to trade, dex routing Accepts payment on Base or Solana — either network works.","url":"https://api.x402node.dev/pool/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["token"],"properties":{"limit":{"type":"string","description":"per side (default 8, max 20)"},"token":{"type":"string","description":"token contract 0x..."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_K96BwRRcgDyffYmhEx7iv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns Uniswap V3 liquidity pools on Ethereum containing a given token, ranked by TVL, with pair, fee tier, and TVL details.","exampleAgentPrompt":"Find all Uniswap V3 pools on Ethereum that contain USDC at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48, ranked by total value locked, so I can see the best liquidity options and fee tiers available.","exampleUseCases":null,"resultDescription":"A ranked list of Uniswap V3 pools containing the queried token, each with the trading pair (e.g. USDC/WETH), fee tier (e.g. 0.05%, 0.3%, 1%), total value locked in USD, and pool contract address — ordered from highest to lowest TVL.","failureModes":["Invalid or non-Ethereum token contract address returns empty results or error","Token with no Uniswap V3 pools returns empty list","Subgraph data lag means very recently created pools may not appear","Rate limiting or payment failure returns 402 or 429 error","Malformed address (wrong checksum, wrong length) returns validation error"],"whenToPreferThis":"Use this endpoint when you need to discover Uniswap V3 liquidity pools for a specific ERC20 token on Ethereum — particularly for DEX routing decisions, liquidity analysis, or finding the best fee tier for a swap. Prefer this over generic DeFi data providers when you need TVL-ranked pool data directly from the Uniswap V3 subgraph without building your own subgraph query.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:54:23.137Z","isFirstParty":false}