# HALOWERK kettenwerk Token Holder Concentration Analyzer

> HALOWERK kettenwerk Token Holder Concentration Analyzer is a paid API for AI agents from kette.halowerk.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-16).

Reads the top holder list of an ERC-20 token from a block explorer, filters out non-human addresses (LPs, bridges, burn addresses, exchange custody), and reports both raw and adjusted holder concentration with labeled evidence for each exclusion.

## Facts

- Endpoint: POST https://kette.halowerk.com/token/holders
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-kettenwerk-token-holder-concentration-analyzer-ccf93068
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0sbImBu2X6XCV8z43tH6O

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-holder-concentration-analyzer-ccf93068 -d '<json body>'
```

Example prompt: Can you check the holder concentration for the USDC token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum, looking at the top 50 holders, and tell me what the adjusted concentration looks like after excluding liquidity pools and exchange wallets?

## When to prefer this

Choose this endpoint when you need a nuanced, evidence-backed holder concentration analysis that distinguishes between real human/entity holders and protocol-owned addresses like LPs and bridges. Prefer it over raw block explorer queries when you need both raw and adjusted figures for comparison, or when you need every exclusion justified with on-chain evidence. Especially useful for due diligence on new or unfamiliar tokens where whale risk and decentralization matter.

## Known failure modes

- Invalid or non-ERC-20 contract address returns an error or empty holder list
- Unsupported chain identifier causes a chain-not-found error
- Block explorer rate limits or outages result in incomplete data
- top_n below 10 or above 100 is rejected by schema validation
- Some addresses may be labeled 'unbekannt' if no on-chain code or public tag can verify them
- Token with very few holders may produce unreliable concentration statistics

## How this service works

Reads the holder list of an ERC-20 token from a public block explorer index and reports concentration. Addresses that do not represent a person or entity - liquidity pools, bridges, burn addresses and exchange custody - are excluded from the adjusted figure and every exclusion is listed with its evidence. The raw top-10 share is reported alongside so both numbers can be compared. Labels are only set when they can be backed by on-chain code or a public tag; otherwise the label is "unbekannt". Lim

## Output

Returns the raw top-N holder share percentage alongside an adjusted concentration figure that excludes non-person addresses such as liquidity pools, bridges, burn addresses, and exchange custody wallets. Each excluded address is listed with its label and the on-chain or public-tag evidence backing that label. Addresses that cannot be verified are labeled 'unbekannt' (unknown).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "description": "Chain identifier, for example ethereum, base, arbitrum or optimism."
  },
  "token": {
   "type": "string",
   "description": "ERC-20 contract address, 0x followed by 40 hex characters."
  },
  "top_n": {
   "type": "integer",
   "default": 20,
   "maximum": 100,
   "minimum": 10,
   "description": "How many holders to examine. Default 20."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-kettenwerk-token-holder-concentration-analyzer-ccf93068/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)