# VerifyLite ERC-20 Token Holder Distribution

> VerifyLite ERC-20 Token Holder Distribution is a paid API for AI agents from verifylite.hydratinghealingtouch.workers.dev, paid per call via x402, $0.0051/call, status unknown (last checked 2026-11-13).

Returns the top holders of an ERC-20 token on Base, ranked by balance, with concentration metrics, wallet type classification, burned token percentage, and supply distribution analysis.

## Facts

- Endpoint: POST https://verifylite.hydratinghealingtouch.workers.dev/chain/holders?utm_source=zero.xyz
- Price: $0.0051/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/verifylite-erc-20-token-holder-distribution-94028c41
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_guSPx6VwFUSEiD-RcXfk7

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 verifylite-erc-20-token-holder-distribution-94028c41 -d '<json body>'
```

Example prompt: Can you pull the top 10 holders of the token at 0x4200000000000000000000000000000000000006 on Base and tell me how concentrated the supply is — including what percent has been burned and whether the concentration level is high?

## When to prefer this

Choose this endpoint when you need on-chain holder distribution data for an ERC-20 token on Base, especially for concentration risk assessment, whale analysis, burn rate evaluation, or token transparency audits. It is superior to general block explorers when you need structured, pre-computed concentration metrics (top-1/5/10 share, wallets-only share, burned percent, concentration level) in a single API call without scraping. Best for DeFi due-diligence workflows, token safety screening, and portfolio risk monitoring on Base.

## Known failure modes

- Invalid or non-existent token contract address returns no charge and an error response
- Token contract exists but is not ERC-20 compliant — may return partial or empty data
- Tokens with very large transfer histories may return approximate holder counts with coverage percentage rather than exact figures
- Limit parameter outside 1–50 range may be rejected or clamped
- Network issues with Base RPC nodes may cause timeouts

## How this service works

The largest holders of an ERC-20 token on Base, ranked, with balance, percent of supply and wallet/contract/burn type, read straight from the chain. Top 1/5/10 concentration (burns excluded), a wallets-only share, burned percent and a low-to-very-high level. For tokens whose whole transfer history fits (most new and small tokens) the list and holder count are exact; otherwise coverage is reported. Not charged for invalid input.

## Output

Returns a ranked list of top ERC-20 token holders on Base with each holder's balance, percentage of total supply, and wallet/contract/burn classification. Also returns aggregate metrics: top-1, top-5, and top-10 supply concentration (excluding burn addresses), a wallets-only share percentage, the percentage of supply that has been burned, an overall concentration level label (low to very-high), and where applicable the total holder count and coverage status for tokens with large transfer histories.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "How many holders to list, 1 to 50 (default 10)."
  },
  "token": {
   "type": "string",
   "description": "Token contract 0x address on Base."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/verifylite-erc-20-token-holder-distribution-94028c41/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from verifylite.hydratinghealingtouch.workers.dev](https://www.zero.xyz/host/verifylite.hydratinghealingtouch.workers.dev/llms.txt)
