# ERC-20 Token Holder Distribution

> ERC-20 Token Holder Distribution is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-29).

Returns the largest holders of an ERC-20 token with labeled addresses, amounts, percentages of supply, total holder count, and top-10 concentration metric.

## Facts

- Endpoint: POST https://api.vextorium.com/token-holders-pago?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/erc-20-token-holder-distribution-228690fa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gU9marDYVPBOMVeTt518R

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 erc-20-token-holder-distribution-228690fa -d '<json body>'
```

Example prompt: Who are the top 20 largest holders of the USDC token (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) on Ethereum — show me their addresses, any known labels like exchanges or protocols, how much they hold, and what percentage of supply that is, plus the top-10 concentration?

## When to prefer this

Use this endpoint when you need on-chain holder distribution data for ERC-20 tokens across major EVM networks (Ethereum, Base, Arbitrum, Optimism, Polygon, zkSync), especially when you need labeled addresses (exchanges, protocols) rather than raw addresses alone. Prefer this over generic blockchain explorers when you want structured, agent-ready JSON with concentration metrics included. Best for DeFi due diligence, tokenomics analysis, whale monitoring, and rug-pull risk assessment.

## Known failure modes

- Invalid or non-ERC-20 contract address returns error or empty result
- Unsupported network (outside ethereum/base/arbitrum/optimism/polygon/zksync) returns validation error
- Token with no holders or very new token may return empty holders array
- Rate limiting or payment failure returns 402 or error response
- Token contract exists but has no indexable holder data on the requested chain

## How this service works

Largest holders of an ERC-20 token: address (named or labelled when known: exchanges, protocols...), amount and % of supply, total holder count and top-10 concentration.

## Output

Returns a JSON object containing: the token's name, symbol, total supply, total holder count, source network, top holders array (each with address, optional ENS/name label, whether it's a contract, token amount held, and percentage of total supply), and a top-10 concentration percentage (concentracion_top10_pct). Addresses are labeled when identifiable as exchanges, DeFi protocols, or known entities.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "red": {
   "enum": [
    "ethereum",
    "base",
    "arbitrum",
    "optimism",
    "polygon",
    "zksync"
   ],
   "type": "string"
  },
  "token": {
   "type": "string"
  },
  "limite": {
   "type": "integer"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc-20-token-holder-distribution-228690fa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)