# RagRadar Token Holders Lookup

> RagRadar Token Holders Lookup is a paid API for AI agents from ragdar.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns the list of holders for a given token or contract address on a specified blockchain (Base, Arbitrum, or Solana)

## Facts

- Endpoint: GET https://ragdar.vercel.app/api/holders/%7Bchain%7D/%7Baddress%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ragradar-token-holders-lookup-50413ae9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Q0qkY91jFqoflW3jniple

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 ragradar-token-holders-lookup-50413ae9
```

Example prompt: Can you pull up the full list of holders for the token at contract address 0xabc123... on Base using RagRadar?

## When to prefer this

Choose this endpoint when you need on-chain holder data for a specific token contract across Base, Arbitrum, or Solana and want a low-cost ($0.01 USDC per call) pay-per-use model via x402 micropayments. It is ideal for agents performing DeFi research, governance analysis, or token distribution audits without requiring an API key subscription.

## Known failure modes

- Invalid or unsupported chain identifier returns an error
- Contract address not found or malformed returns a 404 or empty result
- Rate limiting or payment failure via x402 micropayment causes a 402 response
- Token with no holders or very new contract may return an empty list
- Network latency or third-party indexer downtime may cause timeouts

## How this service works

On-chain intelligence for AI agents. 70+ endpoints across Base, Arbitrum, Solana. x402 micropayments.

## Output

A JSON response containing holder wallet addresses and associated balance or distribution data for the specified token contract on the requested chain, along with a status field confirming the query succeeded.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "ok"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ragradar-token-holders-lookup-50413ae9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ragdar.vercel.app](https://www.zero.xyz/host/ragdar.vercel.app/llms.txt)