# HALOWERK defiwerk Pool Liquidity Lookup

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

Returns liquidity data for a DeFi liquidity pool identified by address or token pair and DEX on a specified EVM-compatible chain

## Facts

- Endpoint: POST https://defi.netzhandwerker.de/pool/liquidity
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-defiwerk-pool-liquidity-lookup-293e37bc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VeQA4aDpI2LgZLKiJDx_A

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-lookup-293e37bc -d '<json body>'
```

Example prompt: What's the liquidity in the USDC/WETH pool on Uniswap V3 on Base — use the 500 ppm fee tier?

## When to prefer this

Use this endpoint when you need on-chain liquidity data for a specific DEX pool on Base, Ethereum, Arbitrum, Optimism, or Polygon, and want a simple paid API call (0.005 USDC via x402) rather than running your own RPC node or indexer. Prefer this over free alternatives when reliability, structured output, and multi-chain support without infrastructure overhead matter. Particularly useful for agents that need to assess pool depth before executing swaps, providing liquidity, or building DeFi dashboards.

## Known failure modes

- Invalid pool address format (must be 0x-prefixed 40-char hex) returns validation error
- Pool not found for given token_a/token_b/dex combination returns empty or error
- Unsupported chain value outside the allowed enum returns schema validation error
- Missing both pool address and the token_a+token_b+dex trio returns a bad request error
- Payment failure or insufficient USDC balance via x402 results in 402 response
- Unrecognized DEX id for the specified chain returns not-found error

## How this service works

HALOWERK defiwerk — bezahlte Endpunkte nach x402. Preise in USDC auf Base Mainnet.

## Output

Returns liquidity metrics for the specified DeFi pool, including data about the pool's liquidity depth, token composition, and relevant on-chain stats, either queried by direct pool contract address or by token pair plus DEX identifier on the requested EVM chain.

## 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-lookup-293e37bc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from defi.netzhandwerker.de](https://www.zero.xyz/host/defi.netzhandwerker.de/llms.txt)