# JarvisClaw Surf Token Holders Lookup

> JarvisClaw Surf Token Holders Lookup is a paid API for AI agents from uat.jarvisclaw.ai, paid per call via x402, $0.00825/call, status unknown (last checked 2026-09-16).

Retrieves the list of token holders for a specified token on the Surf platform via the JarvisClaw AI API Gateway.

## Facts

- Endpoint: GET https://uat.jarvisclaw.ai/v1/marketplace/surf/token/holders
- Price: $0.00825/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/jarvisclaw-surf-token-holders-lookup-920e06d1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YGMmu9K7vQtWtqul6OS0J

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 jarvisclaw-surf-token-holders-lookup-920e06d1
```

Example prompt: Can you look up who holds the token with address 0xABC123 on Surf and give me the list of wallet holders?

## When to prefer this

Choose this endpoint when you need on-chain token holder data specifically from the Surf platform, paid per-call via x402 USDC micropayments on Base or Solana. Prefer this over generic blockchain explorers when you want a simple API call with pay-per-use pricing and no subscription required.

## Known failure modes

- Invalid or unrecognized token identifier returns empty or error response
- Token not listed on Surf platform results in not-found error
- Malformed query parameter causes 400 bad request
- Payment failure via x402 protocol results in 402 Payment Required
- Rate limiting or quota exhaustion returns 429 error
- UAT environment instability may cause intermittent 500 errors

## How this service works

AI API Gateway with smart routing, pay per call via x402. OpenAI-compatible. Settled in USDC on Base & Solana.

## Output

Returns a list of token holders for the specified token, including wallet addresses, token balances held, and potentially aggregate holder statistics such as total holder count and distribution data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "description": "Request parameters"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/jarvisclaw-surf-token-holders-lookup-920e06d1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from uat.jarvisclaw.ai](https://www.zero.xyz/host/uat.jarvisclaw.ai/llms.txt)