# token-top-holders-ethereum

> token-top-holders-ethereum is a paid API for AI agents from chain.intel.rallylive.ca, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-02).

Returns the top 50 holders of any Ethereum ERC-20 token with supply share, balances, contract/exchange labels, burned share, and concentration metrics.

## Facts

- Endpoint: GET https://chain.intel.rallylive.ca/token/holders/ethereum?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-top-holders-ethereum-759864fc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PTNim63pVAAJqKSSqiPmC

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 token-top-holders-ethereum-759864fc
```

Example prompt: Who are the top 50 holders of the PEPE token on Ethereum — show me what percentage of supply the top 10 wallets control, and flag any exchange or contract addresses in the list.

## When to prefer this

Use this endpoint when you need Ethereum-specific token holder concentration data, whale detection, insider analysis, or exchange/contract label identification for ERC-20 tokens. Prefer this over generic blockchain explorers when you need structured, pre-aggregated concentration metrics (top 1/5/10/20) and labeled holder types in a single call. For other chains, use the sibling endpoints (Optimism, BSC, Polygon).

## Known failure modes

- Invalid or non-existent contract address returns an error or empty result
- Non-ERC-20 contract address (e.g. NFT or EOA) may return unexpected data
- Token with very low on-chain activity may have incomplete holder data
- Network timeouts or upstream RPC issues may cause intermittent failures
- Rate limiting if called in rapid succession

## How this service works

Ethereum: Top 50 holders of a token with share of supply, balances, contract/exchange labels, burned share and concentration (top 1/5/10/20). Spot whale-controlled and insider-heavy tokens. $0.03 per call.

## Output

Returns a ranked list of the top 50 holder addresses for the specified Ethereum ERC-20 token, each with their balance and percentage share of total supply. Also includes labels identifying contract or exchange addresses, the share of supply that has been burned, and concentration metrics showing what percentage of supply is held by the top 1, 5, 10, and 20 holders.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-top-holders-ethereum-759864fc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chain.intel.rallylive.ca](https://www.zero.xyz/host/chain.intel.rallylive.ca/llms.txt)