# EVM Token Holder Concentration Analyzer

> EVM Token Holder Concentration Analyzer is a paid API for AI agents from api.fadeandco.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns holder concentration metrics (top 1/3/10 share, total holders, contract ratio) for an EVM token on Ethereum, BSC, Base, Arbitrum, or Polygon using GoPlus data.

## Facts

- Endpoint: GET https://api.fadeandco.workers.dev/api/agent-intel/holder-cluster-analyzer?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/evm-token-holder-concentration-analyzer-4094fe84
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VXGxEQvOFPsu9sr9YKY7C

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 evm-token-holder-concentration-analyzer-4094fe84
```

Example prompt: Can you check the holder concentration for the PEPE token at 0x6982508145454ce325ddbe47a25d4ec3d2311933 on Ethereum — specifically what share the top 1, top 3, and top 10 holders control, how many total holders there are, and whether any of the top holders are contracts?

## When to prefer this

Use this endpoint when you need fast, structured holder concentration data for an EVM token across Ethereum, BSC, Base, Arbitrum, or Polygon and only need the top-10 holder view. Prefer this over manually querying block explorers or GoPlus directly when you need a normalized, parsed response with concentration ratios and contract-holder flags already computed. If you need top-20+ holders or funding-source clustering, this endpoint does not support those.

## Known failure modes

- Invalid or non-contract token address returns an error or empty result
- Unsupported chain name causes a validation error
- Token with very few holders may return partial data
- GoPlus upstream unavailability results in timeout or 5xx error
- Token not indexed by GoPlus returns empty holder array
- Missing required 'address' query parameter returns 400

## How this service works

Holder concentration for an EVM token (Ethereum, BSC, Base, Arbitrum, Polygon): share of supply held by the top 1, top 3 and top 10 holders, total holder count, and how much of the top 10 are contracts. GoPlus gives only the top 10 holders, so the top-20 view and funding-source clustering are NOT provided.

## Output

Returns a JSON object with: token symbol and address, chain, a concentration verdict (e.g. DISPERSED), timestamp, total holder count, number of top holders returned (up to 10), per-holder data (address, percent of supply, locked status, contract flag, tag), and summary concentration figures for top 1, top 3, and top 10 holders. Sourced from GoPlus; top-20 view and funding-source clustering are not available.

## 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": {
      "chain": {
       "type": "string",
       "description": "ethereum, bsc, base, arbitrum or polygon (default ethereum)"
      },
      "address": {
       "type": "string",
       "description": "Token contract address 0x... (40 hex characters)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Top 10 only (GoPlus does not return more). Funding-source clustering is not included.",
  "chain": "ethereum",
  "source": "https://api.gopluslabs.io/api/v1/token_security/",
  "symbol": "PEPE",
  "address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
  "verdict": "DISPERSED",
  "checkedAt": "2026-10-23T09:35:17.979Z",
  "topHolders": [
   {
    "tag": null,
    "locked": false,
    "address": "0xf977814e90da44bfa03b6295a0616a897441acec",
    "percent": 0.08989173829407761,
    "isContract": false
   },
   {
    "tag": null,
    "locked": false,
    "address": "0x1d48963dd8fada6ab5c2c7b92eba81ecc5030270",
    "percent": 0.06166513454219776,
    "isContract": false
   }
  ],
  "totalHolders": 600956,
  "concentration": {
   "top1": 0.0899,
   "top3": 0.1964,
   "top10": 0.3498
  },
  "holdersReturned": 10,
  "contractHoldersInTop10": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/evm-token-holder-concentration-analyzer-4094fe84/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.fadeandco.workers.dev](https://www.zero.xyz/host/api.fadeandco.workers.dev/llms.txt)