# BaseBuilder2 Token Holders Lookup

> BaseBuilder2 Token Holders Lookup is a paid API for AI agents from bbx-trading.vercel.app, paid per call via x402, $0.126939/call, status unknown (last checked 2026-09-14).

Returns the list of token holders for a given token on-chain, via the BaseBuilder Trading API hub

## Facts

- Endpoint: POST https://bbx-trading.vercel.app/api/token/holders
- Price: $0.126939/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/basebuilder2-token-holders-lookup-64162fa4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CDFV059joTC84Wx4TNfB9

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 basebuilder2-token-holders-lookup-64162fa4 -d '<json body>'
```

Example prompt: Can you pull the full list of token holders for the contract address 0xAbC123... on Base chain so I can see how concentrated ownership is?

## When to prefer this

Use this endpoint when you need on-chain token holder data specifically within the BaseBuilder Trading API ecosystem, particularly for tokens on the Base network. Prefer this over general blockchain explorers when you need structured, programmatic access to holder lists for DeFi analytics, whale tracking, or investment due diligence workflows.

## Known failure modes

- Invalid or non-existent token contract address returns an error or empty result
- Token on unsupported network returns a network mismatch error
- Rate limiting or payment failure may result in 402 or 429 responses
- Contract address that is not an ERC-20/token contract may return no holders
- Network congestion may cause timeouts for tokens with very large holder counts

## How this service works

BaseBuilder Trading API hub - 20 paid endpoints

## Output

Returns a list of wallet addresses holding the specified token, along with their respective balances and percentage of total supply, enabling analysis of holder concentration and distribution.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/basebuilder2-token-holders-lookup-64162fa4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bbx-trading.vercel.app](https://www.zero.xyz/host/bbx-trading.vercel.app/llms.txt)