# HALOWERK kettenwerk – Token Liquidity Ownership

> HALOWERK kettenwerk – Token Liquidity Ownership is a paid API for AI agents from kette.netzhandwerker.de, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-14).

Returns the top LP token holders and their ownership breakdown for a given liquidity pool on EVM-compatible chains.

## Facts

- Endpoint: POST https://kette.netzhandwerker.de/token/liquidity-ownership
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-kettenwerk-token-liquidity-ownership-ede5be64
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vwWpZCbyCWj4UcDvn1xIl

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-kettenwerk-token-liquidity-ownership-ede5be64 -d '<json body>'
```

Example prompt: Who are the top 30 LP token holders for the pool at 0xB4e16d0168e52d35CaCD2c6185b44281Ec28C9Dc on Ethereum — and what percentage of liquidity does each one own?

## When to prefer this

Choose this endpoint when you need on-chain LP holder data for a specific liquidity pool across major EVM chains (Ethereum, Base, Arbitrum, Optimism). It is ideal for DeFi due-diligence, whale monitoring, and decentralization audits where you want structured ranked ownership data rather than raw blockchain queries. Prefer it over generic block explorers when you need the distribution pre-ranked and ready to use without writing custom indexing logic.

## Known failure modes

- Invalid or non-existent pool address returns an error or empty result
- Unsupported chain identifier causes a rejection or lookup failure
- top_n below minimum (10) or above maximum (100) results in a validation error
- Pool with fewer holders than top_n requested may return partial results
- Network congestion or RPC issues on the target chain may cause timeouts

## How this service works

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

## Output

A ranked list of the top N LP token holders for the specified liquidity pool, including each holder's wallet address and their proportional share of total liquidity. Useful for assessing concentration risk, whale dominance, and overall decentralization of a pool.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "pool": {
   "type": "string",
   "description": "Address of the liquidity pool (the LP token contract), 0x followed by 40 hex characters."
  },
  "chain": {
   "type": "string",
   "description": "Chain identifier, for example ethereum, base, arbitrum or optimism."
  },
  "top_n": {
   "type": "integer",
   "default": 30,
   "maximum": 100,
   "minimum": 10,
   "description": "How many LP holders to examine. Default 30."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-kettenwerk-token-liquidity-ownership-ede5be64/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kette.netzhandwerker.de](https://www.zero.xyz/host/kette.netzhandwerker.de/llms.txt)