# BaseBuilder Trading Token Holders

> BaseBuilder Trading Token Holders is a paid API for AI agents from bb-trading-gold.vercel.app, paid per call via x402, $0.126939/call, status unknown (last checked 2026-10-21).

Retrieves the list of holders for a specified token on the Base blockchain

## Facts

- Endpoint: POST https://bb-trading-gold.vercel.app/api/token/holders?utm_source=zero.xyz
- Price: $0.126939/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/basebuilder-trading-token-holders-ae74c017
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hVTMyadNxV5yu5eE0TBJe

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 basebuilder-trading-token-holders-ae74c017 -d '<json body>'
```

Example prompt: Show me all the wallet addresses holding the token at contract 0xabc123... on Base — I want to see the holder list and their balances.

## When to prefer this

Use this endpoint when you need to enumerate or analyze the holder distribution of a specific token on the Base blockchain, especially when you want on-chain holder data without running your own indexer. Prefer this over general blockchain explorers when you need structured, programmatic access to holder data.

## Known failure modes

- Invalid or non-existent contract address returns an error or empty result
- Token not deployed on Base returns no data
- Rate limiting or payment failure causes a 402 response
- Malformed request body returns a 400 error
- Very large holder lists may be paginated or truncated

## How this service works

BaseBuilder Trading API hub - 20 paid endpoints

## Output

A list of wallet addresses that hold the specified token, along with their respective balances and potentially a total holder count, enabling analysis of token distribution on the Base blockchain.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/basebuilder-trading-token-holders-ae74c017/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bb-trading-gold.vercel.app](https://www.zero.xyz/host/bb-trading-gold.vercel.app/llms.txt)