# Sleuth AI – Doxx Top Token Holders

> Sleuth AI – Doxx Top Token Holders is a paid API for AI agents from x402.sleuthagent.ai, paid per call via x402, $0.099/call, status unknown (last checked 2026-09-14).

Identifies and resolves the top holders of a given on-chain token, mapping wallet addresses to known entities such as exchanges, market makers, or protocols.

## Facts

- Endpoint: POST https://x402.sleuthagent.ai/api/v1/doxx-top-token-holders
- Price: $0.099/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sleuth-ai-doxx-top-token-holders-9808cd80
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Tz8FUIp274UzntI39A-rw

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 sleuth-ai-doxx-top-token-holders-9808cd80 -d '<json body>'
```

Example prompt: Who are the top 20 holders of PEPE token — can you identify which ones are known entities like exchanges or market makers, and show their balances and percentage of supply?

## When to prefer this

Choose this endpoint when you need to identify and de-anonymize the largest holders of a specific on-chain token, particularly when entity resolution (linking wallets to named organizations) is important. It is especially valuable for due diligence on token investments, assessing supply concentration risk, detecting insider or exchange dominance, or performing competitive intelligence on rival token ecosystems. Prefer it over generic blockchain explorers when you need both raw holder data and identity enrichment in a single call.

## Known failure modes

- Unknown or unrecognized token ticker returns no data or an error
- Contract address on unsupported chain fails with network error
- Payment failure via x402/USDC on Base blocks the request
- Rate limiting or quota exhaustion if called in rapid succession
- Truncated results if holder list exceeds response size limits
- Low-liquidity or very new tokens may have incomplete identity resolution

## How this service works

Pay-per-call on-chain investigation API (x402, USDC on Base).

## Output

Returns a structured list of the top token holders including wallet addresses, token balances, percentage of total supply held, and resolved identity labels for wallets that map to known entities (e.g. exchange hot wallets, market makers, protocols). Also includes a natural-language summary of findings, a request ID, and metadata about the dataset such as row count and whether results were truncated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "n": {},
  "chain": {
   "enum": [
    "auto",
    "base",
    "ethereum",
    "arbitrum",
    "polygon",
    "bsc",
    "robinhood",
    "solana",
    "bnb",
    "robinhoodchain"
   ],
   "type": "string",
   "default": "auto"
  },
  "token": {
   "type": "string",
   "maxLength": 200,
   "minLength": 1
  },
  "conversation_id": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "nodes": [
    {
     "id": "base_sleuth:obs0",
     "rows": [
      [
       "0x1111111111111111111111111111111111111111",
       "12,400,000",
       "41.2%"
      ],
      [
       "0x2222222222222222222222222222222222222222",
       "6,900,000",
       "22.9%"
      ]
     ],
     "tool": "data_miner",
     "title": "Top holders",
     "columns": [
      "wallet",
      "balance",
      "identity"
     ],
     "summary": "Largest current holders by balance.",
     "row_count": 2,
     "truncated": false
    }
   ]
  },
  "response": "Of PEPE's top 20 holders, 4 resolve to known entities: Binance (hot wallet), Wintermute…",
  "request_id": "req_9f8e7d6c5b4a"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sleuth-ai-doxx-top-token-holders-9808cd80/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.sleuthagent.ai](https://www.zero.xyz/host/x402.sleuthagent.ai/llms.txt)