# Pulse-X402 Uniswap/PancakeSwap V3 Liquidity Depth API > Pulse-X402 Uniswap/PancakeSwap V3 Liquidity Depth API is a paid API for AI agents from chain-pluse-production.up.railway.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-13). 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. ## Facts - Endpoint: GET https://chain-pluse-production.up.railway.app/v3-liquidity-distribution?utm_source=zero.xyz - Price: $0.02/call - Payment: x402 - Status: unknown - Last checked: 2026-10-13 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/pulse-x402-uniswap-pancakeswap-v3-liquidity-depth-api-8caba0f0 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LRQMaU0ibHHUu0ZyTBhW5 Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability pulse-x402-uniswap-pancakeswap-v3-liquidity-depth-api-8caba0f0 ``` Example prompt: 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? ## When to prefer this 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. ## Known failure modes - 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) ## How this service works 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. Payment: x402 exact scheme in USDC. Unpaid requests to the public paid endpoint return HTTP 402 with a Payment-Required header. Successful analyses settle independently; failed analyses (4xx/5xx after payment verification) are not settled. Only /v3-liquidity-distribution is a paid x402 resource. Default analysis range: current price ±5%. Maximum rangePct: 50%. Agents should read aiSummary and depth.summary first; depth.ticks is optional detail. Hard limits: max 32 tick-bitmap words, 2000 initialized ticks scanned, 1000 ticks returned. In-memory result cache TTL: 15s (each paid call still settles). ## Output 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. ## Request schema (JSON Schema) ```json { "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 … (truncated) ``` ## Response schema (JSON Schema) ```json { "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." } } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pulse-x402-uniswap-pancakeswap-v3-liquidity-depth-api-8caba0f0/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from chain-pluse-production.up.railway.app](https://www.zero.xyz/host/chain-pluse-production.up.railway.app/llms.txt)