{"uid":"cap_LRQMaU0ibHHUu0ZyTBhW5","slug":"pulse-x402-uniswap-pancakeswap-v3-liquidity-depth-api-8caba0f0","name":"Pulse-X402 Uniswap/PancakeSwap V3 Liquidity Depth API","description":"Single-pool Uniswap V3 / PancakeSwap V3 liquidity depth API. Given a chain and pool, it returns a price-aware summary for humans and agents plus optional tick details via x402 USDC micropayments — no API keys.\n\nPayment: x402 exact scheme in USDC. Unpaid requests to the public paid endpoint return HTTP 402\nwith a Payment-Required header. Successful analyses settle independently;\nfailed analyses (4xx/5xx after payment verification) are not settled.\n\nOnly /v3-liquidity-distribution is a paid x402 resource.\n\nDefault analysis range: current price ±5%.\nMaximum rangePct: 50%.\nAgents should read aiSummary and depth.summary first; depth.ticks is optional detail.\nHard limits: max 32 tick-bitmap words,\n2000 initialized ticks scanned,\n1000 ticks returned.\nIn-memory result cache TTL: 15s (each paid call still settles).","url":"https://chain-pluse-production.up.railway.app/v3-liquidity-distribution?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":["chain","pool"],"properties":{"pool":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Uniswap V3 or PancakeSwap V3-compatible pool contract address."},"chain":{"enum":["bsc","ethereum","base","arbitrum"],"type":"string","description":"Analysis chain slug: bsc (56), ethereum (1), base (8453), or arbitrum (42161)."},"maxPrice":{"type":"number","description":"Optional upper bound as token1 per token0. Must be provided with minPrice.","exclusiveMinimum":0},"minPrice":{"type":"number","description":"Optional lower bound as token1 per token0. Must be provided with maxPrice.","exclusiveMinimum":0},"rangePct":{"type":"number","default":5,"maximum":50,"description":"Current spot price +/-N%. Ignored when minPrice and maxPrice are both provided.","exclusiveMinimum":0},"includeTicks":{"type":"boolean","default":true,"description":"When false, omit depth.ticks while retaining the complete summary."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["meta","pool","depth","aiSummary","note"],"properties":{"meta":{"type":"object","required":["chain","chainId","pool","blockNumber","queriedAt","cache"],"properties":{"pool":{"type":"string"},"cache":{"enum":["HIT","MISS"],"type":"string"},"chain":{"enum":["bsc","ethereum","base","arbitrum"],"type":"string"},"chainId":{"type":"integer"},"queriedAt":{"type":"string"},"blockNumber":{"type":"string"}}},"note":{"type":"string"},"pool":{"type":"object","required":["token0","token1","feeTier","tickSpacing","current"],"properties":{"token0":{"type":"object","required":["address","symbol","decimals"],"properties":{"symbol":{"type":["string","null"]},"address":{"type":"string"},"decimals":{"type":"integer"}}},"token1":{"type":"object","required":["address","symbol","decimals"],"properties":{"symbol":{"type":["string","null"]},"address":{"type":"string"},"decimals":{"type":"integer"}}},"current":{"type":"object","required":["tick","price","activeLiquidity"],"properties":{"tick":{"type":"integer"},"price":{"type":"string","description":"Exact token1 per token0 spot price."},"activeLiquidity":{"type":"string","description":"Virtual active liquidity L, not USD."}}},"feeTier":{"type":"integer"},"tickSpacing":{"type":"integer"}}},"depth":{"type":"object","required":["range","summary"],"properties":{"range":{"type":"object","required":["minPrice","maxPrice","rangePctUsed","defaulted"],"properties":{"maxPrice":{"type":"string"},"minPrice":{"type":"string"},"defaulted":{"type":"boolean"},"rangePctUsed":{"type":["number","null"]}}},"ticks":{"type":"array","items":{"type":"object","required":["tick","price","activeLiquidity","liquidityGross","liquidityNet","relativeLiquidityPct"],"properties":{"tick":{"type":"integer"},"price":{"type":"string"},"liquidityNet":{"type":"string"},"liquidityGross":{"type":"string"},"activeLiquidity":{"type":"string"},"relativeLiquidityPct":{"type":"number"}}},"description":"Omitted when includeTicks=false."},"summary":{"type":"object","required":["initializedTickCount","currentPrice","peakTick","peakPrice","peakActiveLiquidity","peakVsCurrentPct","currentToPeakPct","liquidityBelowPct","liquidityAbovePct","depthHint"],"properties":{"peakTick":{"type":"integer"},"depthHint":{"type":"string"},"peakPrice":{"type":"string"},"currentPrice":{"type":"string"},"currentToPeakPct":{"type":"number"},"peakVsCurrentPct":{"type":"number"},"liquidityAbovePct":{"type":"number","maximum":100,"minimum":0},"liquidityBelowPct":{"type":"number","maximum":100,"minimum":0},"peakActiveLiquidity":{"type":"string"},"initializedTickCount":{"type":"integer"}}}}},"aiSummary":{"type":"object","required":["spot","range","peak","bias","strength","takeaway"],"properties":{"bias":{"type":"string"},"peak":{"type":"string"},"spot":{"type":"string"},"range":{"type":"string"},"strength":{"type":"string"},"takeaway":{"type":"string"}}}}}}}}},"responseSchema":{"type":"json","example":{"meta":{"pool":"0x36696169C63e42cd08ce11f5deeBbCeBae652050","cache":"MISS","chain":"bsc","chainId":56,"queriedAt":"2026-08-11T00:00:00.000Z","blockNumber":"12345678"},"note":"Prices are token1 per token0. activeLiquidity is virtual L, not USD.","pool":{"token0":{"symbol":"WBNB","address":"0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c","decimals":18},"token1":{"symbol":"USDT","address":"0x55d398326f99059fF775485246999027B3197955","decimals":18},"current":{"tick":12345,"price":"3.43644765403282","activeLiquidity":"123456789"},"feeTier":500,"tickSpacing":10},"depth":{"range":{"maxPrice":"3.60827003673446","minPrice":"3.26462527133118","defaulted":true,"rangePctUsed":5},"ticks":[{"tick":12340,"price":"3.43472968882883","liquidityNet":"25000000","liquidityGross":"50000000","activeLiquidity":"150000000","relativeLiquidityPct":100}],"summary":{"peakTick":12340,"depthHint":"Liquidity is concentrated near spot; depth is roughly balanced across the selected range.","peakPrice":"3.43472968882883","currentPrice":"3.43644765403282","currentToPeakPct":82.3,"peakVsCurrentPct":-0.05,"liquidityAbovePct":54.8,"liquidityBelowPct":45.2,"peakActiveLiquidity":"150000000","initializedTickCount":24}},"aiSummary":{"bias":"roughly balanced around spot","peak":"3.43472969 (near spot)","spot":"3.43644765","range":"3.26462527 - 3.60827004 (+/-5%)","strength":"current depth is 82.3% of the local peak","takeaway":"Liquidity is concentrated near spot; depth is roughly balanced across the selected range."}}},"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_DBBIwKksvt0SxwzpHpToz","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 a price-aware liquidity depth summary and optional tick-level breakdown for a single Uniswap V3 or PancakeSwap V3 pool on a given chain, paid via x402 USDC micropayment.","exampleAgentPrompt":"Can you pull the liquidity depth summary for the WBNB/USDT pool at 0x36696169C63e42cd08ce11f5deeBbCeBae652050 on BSC, looking at the current price ±5%, and tell me how balanced the liquidity is around spot?","exampleUseCases":[{"title":"Pre-trade slippage check on Arbitrum","prompt":"Before I swap a large amount through the WETH/USDC pool at 0xC6962004f452bE9203591991D15f6b388e09E8D0 on Arbitrum, can you check the liquidity depth within ±10% of spot and tell me if there's enough depth to absorb the trade without major slippage?"},{"title":"Market-making range analysis on Base","prompt":"I'm setting up a Uniswap V3 position on the USDC/ETH pool at 0xd0b53D9277642d899DF5C87A3966A349A798F224 on Base — can you show me where liquidity is concentrated between a minPrice of 1800 and maxPrice of 2200 so I know the best range to provide in?"},{"title":"DeFi dashboard liquidity monitoring on Ethereum","prompt":"For my DeFi dashboard, pull the current liquidity distribution summary for the USDC/WETH 0.05% Uniswap V3 pool at 0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640 on Ethereum with the default ±5% range and include tick-level detail."}],"resultDescription":"A JSON object containing pool metadata (tokens, fee tier, current tick/price), a depth analysis over the requested price range (peak tick, liquidity above/below spot percentages, initialized tick count, per-tick liquidity data), and an AI-friendly aiSummary block with spot price, peak price, bias, strength, and a plain-English takeaway. Also includes cache status and block number.","failureModes":["HTTP 402 Payment Required if the x402 USDC payment header is missing or invalid","Invalid pool address (not a 0x-prefixed 40-hex-char address) returns 4xx","Unsupported chain slug returns 4xx","minPrice/maxPrice provided without the other returns 4xx","rangePct exceeds 50% returns 4xx","Pool not found or not a V3-compatible pool returns 4xx/5xx","Too many initialized ticks (>2000) may be capped at hard limits","15-second cache may return slightly stale data (still settled per call)"],"whenToPreferThis":"Choose this endpoint when you need a quick, human- and agent-readable liquidity depth snapshot for a specific Uniswap V3 or PancakeSwap V3 pool on Ethereum, Base, Arbitrum, or BSC — especially for pre-trade slippage assessment, market-making range selection, or DeFi dashboard enrichment. It is ideal when you do not want to manage API keys and are comfortable with x402 USDC micropayments. Prefer it over raw on-chain RPC calls when you want a pre-computed, summarized view with an AI summary block rather than raw tick data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:37:46.348Z","isFirstParty":false,"canonicalSlug":"pulse-x402-uniswap-pancakeswap-v3-liquidity-depth-api-8caba0f0"}