# BBX Trading Holder Distribution

> BBX Trading Holder Distribution is a paid API for AI agents from bbx-trading.vercel.app, paid per call via x402, $0.160666/call, status unknown (last checked 2026-10-21).

Returns the token holder distribution breakdown for a given asset tracked by the BaseBuilder Trading platform

## Facts

- Endpoint: POST https://bbx-trading.vercel.app/api/holder/distribution?utm_source=zero.xyz
- Price: $0.160666/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bbx-trading-holder-distribution-0cdba1f1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xv2v8frhw2oBnxglPLCRY

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 bbx-trading-holder-distribution-0cdba1f1 -d '<json body>'
```

Example prompt: Can you pull the holder distribution for this token — I want to see how concentrated the supply is, like how much the top wallets control versus the smaller holders?

## When to prefer this

Use this endpoint when you need on-chain holder distribution data for a specific token through the BaseBuilder Trading platform. Prefer this over generic blockchain explorers when you want structured, pre-processed tier breakdowns suitable for trading analysis or tokenomics research.

## Known failure modes

- Invalid or unrecognized token address returns an error or empty result
- Unsupported blockchain network causes lookup failure
- Missing required body parameters returns a 400 or 422 validation error
- Payment not included or insufficient USDC causes a 402 Payment Required response
- Rate limiting or upstream data unavailability returns a 503 or timeout

## How this service works

BaseBuilder Trading API hub - 20 paid endpoints

## Output

Returns a structured breakdown of token holder distribution, including wallet tier counts, percentage of supply held by top holders, and concentration metrics indicating whether a token is whale-dominated or broadly distributed.

## More

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