# Kette LP Token Liquidity Ownership Analyzer

> Kette LP Token Liquidity Ownership Analyzer is a paid API for AI agents from kette.halowerk.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-14).

Analyzes the holders of an LP (liquidity provider) token and categorizes them into burned (permanently removed), locked (held in named locker contracts), and free (circulating) supply, with curated locker identification.

## Facts

- Endpoint: POST https://kette.halowerk.com/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/kette-lp-token-liquidity-ownership-analyzer-a6fc4631
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pqs1b34EoJDtn8bwqyhRk

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 kette-lp-token-liquidity-ownership-analyzer-a6fc4631 -d '<json body>'
```

Example prompt: Can you check the LP token ownership for this Uniswap pair token at 0xABC123... on Ethereum and tell me how much of the liquidity is burned, how much is locked in a named locker, and how much is free to be withdrawn?

## When to prefer this

Use this endpoint when you need to assess the security and lock status of a DeFi project's liquidity by examining LP token holders on-chain. It is specifically designed to distinguish between burned (irreversible) and locked (temporary) liquidity — a distinction most generic holder tools collapse. The curated locker table adds named identification for common locker contracts, making it more reliable than raw holder analysis. Prefer this over generic ERC-20 holder endpoints when the token in question is a Uniswap/DEX LP token and you specifically need liquidity security analysis.

## Known failure modes

- Token address not found or invalid — returns error with address details
- Unsupported chain — endpoint may not index all EVM chains
- Block explorer index unavailable — data cannot be fetched
- Locker contract not in curated table — returns is_locker: 'unbekannt' rather than false, indicating uncertainty
- Rate limit or payment failure — x402 payment required per call

## How this service works

Reads the holders of an LP token and splits them into burned, locked in a named locker, and free. Burned and locked are two different things and are reported separately - burned is gone for good, locked comes back. A locker contract that is not in the curated table yields is_locker "unbekannt" rather than false, because an unknown lock contract is not the same as a demonstrably free holder. Limits: earliest_unlock_ts is NOT read - the unlock time lives inside each locker contract in its own layo

## Output

Returns a breakdown of LP token holders grouped into three categories: burned (permanently destroyed, gone from circulation), locked (held in locker contracts — named if in the curated table, or flagged as 'unbekannt' if the locker is unrecognized), and free (fully circulating and withdrawable). Each holder entry includes the is_locker flag with the locker's name or 'unbekannt' for unknown contracts. Does not include earliest_unlock_ts as unlock time requires reading each individual locker contract.

## 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/kette-lp-token-liquidity-ownership-analyzer-a6fc4631/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kette.halowerk.com](https://www.zero.xyz/host/kette.halowerk.com/llms.txt)