# Token Top Holders Lookup

> Token Top Holders Lookup is a paid API for AI agents from the-stall.intuitek.ai, paid per call via x402, $0.059/call, status unknown (last checked 2026-09-14).

Returns the top holders of an ERC-20 token by wallet address and balance, given a contract address.

## Facts

- Endpoint: GET https://the-stall.intuitek.ai/cap/token-top-holders
- Price: $0.059/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-top-holders-lookup-78db61c5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pb0I5EpJ_um0p4_W-3-nU

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-lookup-78db61c5
```

Example prompt: Who are the top 50 holders of the USDC token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?

## When to prefer this

Use this endpoint when you need on-chain holder distribution data for any Ethereum ERC-20 token without requiring API keys or account setup. Ideal for DeFi analytics, whale tracking, token audit, or concentration risk assessment. Prefer over alternatives when paying per-call in USDC on Base mainnet is acceptable and no long-term subscription is desired.

## Known failure modes

- Invalid or malformed token contract address returns an error
- Contract address does not correspond to an ERC-20 token — may return empty or error
- Limit exceeds 100 — clamped or rejected
- Payment failure via x402/USDC causes 402 response and no data returned
- Token has no indexed holders (very new or obscure contract) — empty result

## How this service works

Returns top holders for any Ethereum ERC-20 token (by contract address), with concentration metrics. Includes each holder's share%, human-readable balance (with decimal conversion), and whale analysis. Reports: top-10 concentration, whale count (>1% holders), Herfindahl-Hirschman Index for concentration risk. Use to assess token distribution health, identify institutional-grade holders, or screen for rug-pull risk before entering a position.

## Output

A ranked list of up to 100 wallet addresses and their token balances for the specified ERC-20 contract, ordered by holdings descending — useful for analyzing token concentration, identifying whales, or auditing holder distribution.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "limit": 10,
   "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-top-holders-lookup-78db61c5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from the-stall.intuitek.ai](https://www.zero.xyz/host/the-stall.intuitek.ai/llms.txt)