# Blockscout Token Holders List

> Blockscout Token Holders List is a paid API for AI agents from api.blockscout.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Returns a paginated list of addresses holding a specific token on a given blockchain network, sorted by balance

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/tokens/%7Baddress_hash_param%7D/holders
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-token-holders-list-117877fb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8KXs57r8mzcPzI1chYA4p

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 blockscout-token-holders-list-117877fb
```

Example prompt: Can you pull the list of holders for the token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum (chain ID 1) using Blockscout, and show me the top 50?

## When to prefer this

Use this endpoint when you need to enumerate all holder addresses for a specific token contract on a supported blockchain network via Blockscout's multichain infrastructure. It is ideal for token distribution analysis, airdrop targeting, governance participation checks, and NFT ownership audits. Prefer it over generic blockchain RPC calls when you need enriched holder metadata (ENS names, tags, scam flags, verification status) alongside balances, and when you need cross-chain coverage via a single API.

## Known failure modes

- Invalid or unsupported chain_id returns an error or empty result
- Non-existent or malformed token address returns empty items array
- Token contract with no holders returns empty items array
- Pagination cursor mismatch causes incomplete or duplicate results
- Rate limiting or payment failure (x402) blocks the request

## How this service works

Explore crypto activities with Blockscout's multichain search. Find transactions, addresses, tokens, and dapps across top blockchain networks — your go-to explorer for cross-chain blockchain data

## Output

Returns a paginated JSON array of token holder objects, each containing the holder's address hash, name, ENS domain, verification status, scam flag, proxy type, reputation, public/private tags, watchlist names, token value held, and token ID (for NFTs). Also includes next_page_params for cursor-based pagination through large holder lists.

## 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",
     "properties": {
      "chain_id": {
       "type": "string"
      },
      "address_hash_param": {
       "type": "string"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "value": {
       "type": "string"
      },
      "items_count": {
       "type": "integer"
      },
      "address_hash": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "value": "string",
    "address": {
     "hash": "string",
     "name": "string",
     "is_scam": true,
     "metadata": {},
     "proxy_type": "string",
     "reputation": "string",
     "is_contract": true,
     "is_verified": true,
     "public_tags": [
      {
       "label": "string",
       "address_hash": "string",
       "display_name": "string"
      }
     ],
     "private_tags": [
      {
       "label": "string",
       "address_hash": "string",
       "display_name": "string"
      }
     ],
     "ens_domain_name": "string",
     "implementations": [
      {
       "name": "string",
       "address_hash": "string"
      }
     ],
     "watchlist_names": [
      {
       "label": "string",
       "display_name": "string"
      }
     ]
    },
    "token_id": "string"
   }
  ],
  "next_page_params": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-token-holders-list-117877fb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.blockscout.com](https://www.zero.xyz/host/api.blockscout.com/llms.txt)