# HALOWERK defiwerk Pool Liquidity Reader

> HALOWERK defiwerk Pool Liquidity Reader is a paid API for AI agents from defi.halowerk.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

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.

## Facts

- Endpoint: POST https://defi.halowerk.com/pool/liquidity
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-defiwerk-pool-liquidity-reader-4d0969aa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YCRCMza62YeRTKsiZRH9b

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 halowerk-defiwerk-pool-liquidity-reader-4d0969aa -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-defiwerk-pool-liquidity-reader-4d0969aa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from defi.halowerk.com](https://www.zero.xyz/host/defi.halowerk.com/llms.txt)