{"uid":"cap_YCRCMza62YeRTKsiZRH9b","slug":"halowerk-defiwerk-pool-liquidity-reader-4d0969aa","name":"HALOWERK defiwerk Pool Liquidity Reader","description":"Resolves a pool either by address or by chain, token pair and DEX, then reads token0, token1, fee tier, reserves, in-range liquidity and the current tick straight from the contract. Exit impact is not estimated from a formula but simulated: for Uniswap V3 through the official Quoter contract via eth_call, which walks the same ticks a real swap would and reports how many it crossed; for constant-product and Solidly pools through the pool maths or the pool own getAmountOut. Nothing is ever execute","url":"https://defi.halowerk.com/pool/liquidity","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"dex":{"type":"string","description":"DEX id, required together with token_a and token_b."},"pool":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Pool address. Either this or token_a plus token_b plus dex."},"chain":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string"},"token_a":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"token_b":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"fee_tier_ppm":{"enum":[100,500,3000,10000],"type":"integer","description":"Optional fee tier in parts per million for Uniswap V3. Omitted means the deepest tier."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_q1Shn23u2hO_pq-XCDnpL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a DeFi liquidity pool by address or token pair/DEX, then reads on-chain reserves, in-range liquidity, current tick, and fee tier directly from the contract with exit impact simulated via quoter contracts.","exampleAgentPrompt":"Can you pull the current reserves, in-range liquidity, and current tick for the WETH/USDC Uniswap V3 pool with a 500 ppm fee tier on Base — I need to know how deep the pool is before I move a large position.","exampleUseCases":[{"title":"Check Uniswap V3 pool depth before trading","prompt":"What's the current in-range liquidity and tick for the WETH/USDC Uniswap V3 pool on Ethereum using the 3000 ppm fee tier? I want to see how deep it is before placing a large order."},{"title":"Compare pool reserves by token pair and DEX","prompt":"Can you look up the reserves and liquidity for the USDC/DAI pool on Curve on Arbitrum? I need the raw on-chain numbers, not an estimate."},{"title":"Simulate exit impact for a large DeFi position","prompt":"I'm about to exit a big position in the WBTC/ETH Uniswap V3 pool at 0x1234...abcd on Polygon — can you simulate how many ticks the swap would cross and what the exit impact looks like?"}],"resultDescription":"Returns token0 and token1 addresses, fee tier, pool reserves, amount of in-range liquidity, and the current tick read directly from the contract. For Uniswap V3, exit impact is simulated via the official Quoter contract (eth_call) reporting ticks crossed; for constant-product and Solidly pools, exit impact uses pool math or getAmountOut. No transaction is ever submitted.","failureModes":["Pool address not found or invalid (0x address malformed)","Token pair + DEX combination does not resolve to a known pool","Chain not supported (only base, ethereum, arbitrum, optimism, polygon)","Fee tier provided does not match any existing pool tier","RPC or contract call failure for the given chain","Pool exists but has zero liquidity, returning empty reserves","Invalid DEX id provided with token pair"],"whenToPreferThis":"Choose this endpoint when you need raw, on-chain liquidity data (reserves, tick, in-range liquidity) for a specific pool and want exit impact simulated — not estimated from a formula — via the same code path a real swap would use. Prefer it over generic price APIs when you need tick-level granularity for Uniswap V3 or accurate constant-product math for Solidly pools, and when you need to avoid any on-chain execution side effects.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:36:09.586Z","isFirstParty":false}