{"uid":"cap_9vcunxVytxMfvyMTYGtXZ","slug":"chainray-liquidity-depth-f8ce2ad6","name":"ChainRay Liquidity Depth","description":"The most complete blockchain data and intelligence service for AI agents. 93 endpoints across 46 chains, from gas fees to DeFi analytics, with real-time streams, intent routing, and verifiable proofs. Pay-per-request via x402.","url":"https://chainray.online/liquidity-depth/%7BtokenA%7D/%7BtokenB%7D","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"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["tokenA","tokenB"],"properties":{"chain":{"type":"string"},"tokenA":{"type":"string"},"tokenB":{"type":"string"}}}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"chain":"ethereum","tokenA":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","tokenB":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"}}},"response":{"fee":"0.05%","note":"Active liquidity at current tick. Full tick-range depth requires scanning individual tick accounts (expensive on public RPCs).","pool":"0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640","chain":"ethereum","_proof":{"chain":"ethereum","dataHash":"8aa3cde9ff7236c7b34bb561da15534dec843c3beeb4cd8ba51afe78d6a42005","blockHash":"0x7ea60ba5c3edf5a31b2c8f8785e032640c16d3538fdd94db16501fda995bd9cb","chainName":"Ethereum","blockNumber":25342521,"proofVersion":"3.0","blockTimestamp":1781762483,"proofTimestamp":1781762488020},"token0":{"symbol":"USDC","address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","decimals":6},"token1":{"symbol":"0xC02aaA39...","address":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","decimals":18},"chainName":"Ethereum","timestamp":1781762488020,"currentTick":201767,"tickSpacing":10,"currentPrice":"0.00057838","sqrtPriceX96":"1905401804023139254050586921743542","liquidityHuman":"5.8220","activeLiquidity":"5822001804446870098"}},"exampleRequest":{"chain":"ethereum","tokenA":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","tokenB":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_LKL0sZvZhgQYeGDGijg2W","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 the order book liquidity depth between two tokens on a specified blockchain, showing buy/sell depth at various price levels","exampleAgentPrompt":"Can you pull the on-chain liquidity depth between WETH and USDC on Ethereum using ChainRay, so I can see how deep the order book is before I execute a large swap?","exampleUseCases":null,"resultDescription":"Returns structured liquidity depth data for the specified token pair, including bid and ask depth at various price levels, available liquidity pools, and price impact estimates for different trade sizes on the requested blockchain.","failureModes":["Invalid or unsupported token address/symbol returns 400 or empty result","Unsupported chain identifier returns an error or no data","Token pair with no existing liquidity pools returns empty depth data","Network timeout or chain RPC unavailability causes 503","Payment failure via x402 protocol returns 402 with payment requirements"],"whenToPreferThis":"Use this endpoint when you need granular order book or liquidity pool depth data for a specific token pair on a specific blockchain — particularly before executing large trades or swaps where slippage matters. Prefer this over general token price endpoints when you need to understand available liquidity at multiple price levels rather than just spot price.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-08T12:44:52.365Z","isFirstParty":false}