# HALOWERK kettenwerk — ERC-20 Token Holder Lookup

> HALOWERK kettenwerk — ERC-20 Token Holder Lookup is a paid API for AI agents from kette.netzhandwerker.de, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-14).

Returns the top N holders of a given ERC-20 token on a specified EVM-compatible chain

## Facts

- Endpoint: POST https://kette.netzhandwerker.de/token/holders
- Price: $0.004/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-erc-20-token-holder-lookup-6921d833
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Yt7fWGrWfG-aDj1fjW9uF

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-erc-20-token-holder-lookup-6921d833 -d '<json body>'
```

Example prompt: Who are the top 20 holders of the USDC token (contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) on Ethereum?

## When to prefer this

Choose this endpoint when you need on-chain holder distribution data for any ERC-20 token across major EVM chains (Ethereum, Base, Arbitrum, Optimism) and want a ranked list of top wallets. It is ideal for DeFi due diligence, whale tracking, and token concentration analysis. Prefer this over generic blockchain explorers when you need programmatic, structured holder data payable via x402 microtransaction.

## Known failure modes

- Invalid or non-ERC-20 contract address returns an error
- Unsupported chain identifier causes a bad request response
- top_n value outside the 10–100 range is rejected
- Contract address not found on the specified chain returns empty or error
- Payment failure via x402 protocol blocks the request

## How this service works

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

## Output

A ranked list of up to 100 wallet addresses that hold the most of the specified ERC-20 token on the given chain, including their balances or share of supply, ordered from largest to smallest holder.

## 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-erc-20-token-holder-lookup-6921d833/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)