# ERC-20 Top Holder Concentration Report

> ERC-20 Top Holder Concentration Report is a paid API for AI agents from meryol-agenticmarket-x402.hf.space, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-11).

Returns top-N holder analysis for an ERC-20 token including concentration percentages, contract/EOA flags, and well-known wallet labels for rug/sniper risk assessment.

## Facts

- Endpoint: GET https://meryol-agenticmarket-x402.hf.space/holders/top/:chain/:token?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/meryol-agenticmarket-x402-hf-space-20e5d7e7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UhSbeTLl__0Jldl1Reue_

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 meryol-agenticmarket-x402-hf-space-20e5d7e7
```

Example prompt: Before I ape into this token, can you pull the top holder concentration report for 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum and tell me if it's dangerously concentrated or if any whales are contracts that could dump?

## When to prefer this

Use this endpoint when an agent needs to perform a pre-trade rug check or whale concentration assessment on an ERC-20 token on Ethereum, Base, Arbitrum, or Optimism. Prefer this over generic block explorers when you need structured, machine-readable concentration metrics with LP/router exclusion and contract labeling in a single call.

## Known failure modes

- Invalid or non-checksummed token address returns 400
- Unsupported chain returns 400 with enum error
- Token with no on-chain holder data (e.g. newly deployed) may return empty or partial results
- Payment not provided or insufficient returns 402
- Rate limiting or upstream RPC failure returns 503
- Non-ERC-20 contract address may return unexpected or empty holder data

## How this service works

Pre-trade exit-liquidity check for an ERC-20: top-10 holder concentration %, ex-LP/ex-known-router concentration, per-holder balance %, contract-or-EOA flag. High concentration = thin exit liquidity. Chains: ethereum, base, arbitrum, optimism.

## Output

A structured report containing: the top-N holder list with per-holder balance percentages, total top-10 concentration percentage, concentration excluding known LPs and routers, a contract-or-EOA flag for each address, and well-known labels (e.g. Uniswap LP, known sniper) where available.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "pathParams": {
   "chain": "ethereum",
   "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
  },
  "queryParams": {}
 }
}
```

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "chain",
      "token"
     ],
     "properties": {
      "chain": {
       "enum": [
        "ethereum",
        "base",
        "arbitrum",
        "optimism"
       ],
       "type": "string"
      },
      "token": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "holders",
      "top_n_concentration_pct"
     ]
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/meryol-agenticmarket-x402-hf-space-20e5d7e7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from meryol-agenticmarket-x402.hf.space](https://www.zero.xyz/host/meryol-agenticmarket-x402.hf.space/llms.txt)