# Agent Data Bench – Token Top Holders

> Agent Data Bench – Token Top Holders is a paid API for AI agents from x402.deepsense.stream, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-28).

Returns the top token holders for a Solana SPL or EVM ERC-20 token, including wallet address, balance, percent of supply, labels/tags, and first-seen timestamp.

## Facts

- Endpoint: GET https://x402.deepsense.stream/api/v1/market/holders?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-data-bench-token-top-holders-43405aa6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4yx20GRXuJpouEBNkh4w0

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 agent-data-bench-token-top-holders-43405aa6
```

Example prompt: Who are the top 50 holders of the Solana token at mint address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v? Show me their balances, percent of supply, and any labels — I want to check for whale concentration.

## When to prefer this

Use this endpoint when you need ready-to-use holder concentration data with percent-of-supply already computed, across Solana SPL tokens and ERC-20s on Ethereum and Base. Prefer it over raw blockchain RPC calls when you need labeled/tagged wallets and first-seen timestamps in a single call without manual post-processing.

## Known failure modes

- Invalid or unsupported token contract address returns an error or empty list
- Chain mismatch — passing an EVM address with chain=sol or vice versa
- Limit exceeds maximum of 100 — returns validation error
- Token with very low on-chain activity may return fewer holders than requested
- Network timeouts for tokens with very large holder sets
- Unknown or unresolvable mint address returns 404 or empty response

## How this service works

Top token holders with wallet, balance, percent of supply, labels/tags and first-seen time. Percent of supply is computed for you from total supply, so the result is ready for concentration checks, whale tracking or airdrop analysis. Works for Solana SPL and ERC-20 tokens on Base and Ethereum.

## Output

A ranked list of top token holders, each containing the wallet address, raw token balance, percent of total supply, any known labels or tags (e.g. exchange, whale, team), and the timestamp when the wallet was first seen holding the token. Results are pre-computed for concentration checks, whale tracking, and airdrop analysis.

## 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": [
      "chain",
      "token"
     ],
     "properties": {
      "chain": {
       "enum": [
        "sol",
        "eth",
        "base"
       ],
       "type": "string",
       "description": "Chain id: sol (Solana), eth (Ethereum), base (Base)"
      },
      "limit": {
       "type": "integer",
       "default": 50,
       "maximum": 100,
       "minimum": 1
      },
      "token": {
       "type": "string",
       "description": "Token contract / mint address"
      },
      "orderBy": {
       "enum": [
        "amount",
        "createdAt"
       ],
       "type": "string",
       "default": "amount"
      },
      "direction": {
       "enum": [
        "asc",
        "desc"
       ],
       "type": "string",
       "default": "desc"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-data-bench-token-top-holders-43405aa6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.deepsense.stream](https://www.zero.xyz/host/x402.deepsense.stream/llms.txt)