{"uid":"cap_CyLxDINLROOqR7KoTiya1","slug":"agent-data-tools-revmesh2074-workers-dev-uniswap-pool-liquidity-33c4cd3d","name":"Uniswap Pool Liquidity: Reserves and Price","description":"Uniswap pool liquidity for a token pair: every Uniswap v3 pool by fee tier with its in-range liquidity, both token balances held, price and current tick, deepest first, read live on Base, Ethereum, Arbitrum, Optimism or Polygon. Use to check a pool's depth before a swap or to price a token from its pool.","url":"https://agent-data-tools.revmesh2074.workers.dev/uniswap/liquidity?utm_source=zero.xyz","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":["tokenA","tokenB"],"properties":{"chain":{"type":"string","examples":["base"],"description":"ethereum (default), base, arbitrum, optimism or polygon"},"tokenA":{"type":"string","examples":["WETH"],"description":"First token: 0x address or ticker"},"tokenB":{"type":"string","examples":["USDC"],"description":"Second token: 0x address or ticker"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"chain":{"type":"string"},"pools":{"type":"array","items":{"type":"object","properties":{"tick":{"type":"number"},"address":{"type":"string"},"feeTier":{"type":"number"},"balanceA":{"type":"number"},"balanceB":{"type":"number"},"liquidity":{"type":"string"},"priceAinB":{"type":"number"},"priceBinA":{"type":"number"}}}},"source":{"type":"string"},"tokenA":{"type":"object","properties":{"symbol":{"type":"string"},"address":{"type":"string"}}},"tokenB":{"type":"object","properties":{"symbol":{"type":"string"},"address":{"type":"string"}}}}}}}}},"responseSchema":{"type":"json","example":{"chain":"Base","pools":[{"tick":-199500,"address":"0xd0b53D9277642d899DF5C87A3966A349A798F224","feeTier":500,"balanceA":5100.2,"balanceB":9800000.5,"liquidity":"1234567890123","priceAinB":2338.2,"priceBinA":0.000427679}],"source":"Uniswap v3 factory and pool contracts, read live","tokenA":{"symbol":"WETH","address":"0x4200000000000000000000000000000000000006"},"tokenB":{"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5UjN5g2ysSK22j9BnV-wu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agent-data-tools.revmesh2074.workers.dev","brandSlug":"agent-data-tools-revmesh2074-workers-dev-x402","brandBaseUrl":"https://agent-data-tools.revmesh2074.workers.dev","brandDocsUrl":null,"whatItDoes":"Returns all Uniswap v3 pools for a token pair across fee tiers with in-range liquidity, token balances, current price, and tick — sorted deepest first — on Base, Ethereum, Arbitrum, Optimism, or Polygon.","exampleAgentPrompt":"What's the current liquidity and price across all Uniswap v3 fee tiers for WETH/USDC on Ethereum — I want to know which pool is deepest before I do a large swap.","exampleUseCases":[{"title":"Pre-swap pool depth check","prompt":"Before I swap 500,000 USDC for WETH on Arbitrum, can you check all the Uniswap v3 pools for that pair and tell me which fee tier has the deepest liquidity?"},{"title":"Token price from Uniswap pool","prompt":"What's the current price of ARB in USDC on Uniswap on Arbitrum? Pull it from the live pool data."},{"title":"Comparing pool depth across fee tiers","prompt":"Show me all the Uniswap v3 pools for WBTC and WETH on Ethereum — I want to see the liquidity, token balances, and price for each fee tier so I can decide which one to route through."}],"resultDescription":"Returns an array of Uniswap v3 pool objects sorted by in-range liquidity descending. Each pool includes its contract address, fee tier (e.g. 500, 3000, 10000), in-range liquidity as a string, token balance for each side, the current price in both directions (priceAinB and priceBinA), and the current tick. Also returns the resolved token symbols and addresses for both inputs, plus the chain queried.","failureModes":["Unrecognized ticker symbol — returns error if tokenA or tokenB ticker cannot be resolved to an address","No pools found — returns empty pools array if no Uniswap v3 pool exists for the pair on the specified chain","Unsupported chain — error if a chain name other than ethereum, base, arbitrum, optimism, or polygon is supplied","RPC timeout — on-chain read may time out during congestion, resulting in a 5xx error","Token address typo — invalid 0x address returns an error or empty result"],"whenToPreferThis":"Use this endpoint when you need live, on-chain Uniswap v3 pool data — specifically liquidity depth, token reserves, and spot price — across all fee tiers for a pair, before routing or sizing a swap. Prefer this over centralized price APIs when you need to verify actual on-chain depth rather than an aggregated index price, or when you need the pool address itself for further on-chain interaction. It covers five major EVM chains, making it the right choice for multi-chain DeFi workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T06:21:55.589Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-revmesh2074-workers-dev-uniswap-pool-liquidity-33c4cd3d"}