# BaseBuilder Trading - Holder Distribution

> BaseBuilder Trading - Holder Distribution is a paid API for AI agents from bb-trading-gold.vercel.app, paid per call via x402, $0.160666/call, status unknown (last checked 2026-09-13).

Returns the distribution of token holders for a given asset on Base, showing how holdings are spread across wallet addresses

## Facts

- Endpoint: POST https://bb-trading-gold.vercel.app/api/holder/distribution
- Price: $0.160666/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/basebuilder-trading-holder-distribution-61c9bd3b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fa3AnuH-nTwrEXGsPOhim

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-holder-distribution-61c9bd3b -d '<json body>'
```

Example prompt: Can you pull the holder distribution for the token at address 0xABCDEF... on Base and tell me how concentrated the holdings are — like how much is held by the top wallets versus smaller holders?

## When to prefer this

Use this endpoint when you need on-chain holder distribution analytics specifically for tokens on the Base blockchain. Prefer this over generic blockchain explorers when you want structured, segmented distribution data suitable for programmatic analysis. Best suited for DeFi due diligence, whale concentration checks, and decentralization audits.

## Known failure modes

- Invalid or non-existent contract address returns an error or empty result
- Token not deployed on Base network causes lookup failure
- Rate limiting or payment failure returns 402 or 429 status
- Newly deployed token with no holders may return sparse or empty distribution
- Network congestion may cause timeout for tokens with extremely large holder counts

## How this service works

BaseBuilder Trading API hub - 20 paid endpoints

## Output

Returns a breakdown of how a token's supply is distributed across holder wallet addresses, typically including bucket tiers (e.g. whales, mid-tier, small holders), counts of wallets per tier, and percentage of total supply held by each segment.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/basebuilder-trading-holder-distribution-61c9bd3b/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)