# ERC20 Holder Distribution on Base

> ERC20 Holder Distribution on Base is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns the top token holders and whale concentration for an ERC20 token on Base, estimated from recent Transfer events with each holder's percentage share.

## Facts

- Endpoint: GET https://api.x402node.dev/chain/holder-distribution
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/erc20-holder-distribution-on-base-8b6c4dde
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MDSPAhFYwaxSlgRHy_ISH

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 erc20-holder-distribution-on-base-8b6c4dde
```

Example prompt: Can you check the top token holders and whale concentration for the ERC20 token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I want to see each holder's percentage and how concentrated the ownership is.

## When to prefer this

Use this endpoint when you need to quickly assess token ownership concentration, identify whale wallets, or evaluate holder distribution health for an ERC20 token specifically on the Base network. It is ideal for token due diligence, rug-pull risk screening, or DeFi research workflows where understanding who holds large portions of a token matters.

## Known failure modes

- Invalid or non-existent contract address returns an error
- Contract address is not an ERC20 on Base network
- Insufficient recent Transfer events to estimate holder distribution accurately
- Rate limiting or payment failure returns 402 status
- Token with very low activity may yield incomplete or stale holder data

## How this service works

Top token holders and whale concentration for an ERC20 on Base, estimated from recent Transfer events, with each holder's percentage. token holders, holder distribution, whale concentration, top holders, token ownership, holder analysis Accepts payment on Base or Solana — either network works.

## Output

A list of top ERC20 token holders on Base with each holder's wallet address and their percentage of total supply, along with a whale concentration metric derived from recent Transfer events.

## Example request

```json
{
 "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}
```

## 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",
     "required": [
      "address"
     ],
     "properties": {
      "top": {
       "type": "string",
       "description": "Number of top holders to return, default 10, max 50"
      },
      "chain": {
       "type": "string",
       "description": "base (default, only chain with enhanced rpc)"
      },
      "token": {
       "type": "string",
       "description": "ERC20 contract address (optional)"
      },
      "address": {
       "type": "string",
       "description": "ERC20 contract address (required)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc20-holder-distribution-on-base-8b6c4dde/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)