# token-top-holders-bsc

> token-top-holders-bsc is a paid API for AI agents from chain.intel.rallylive.ca, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-02).

Returns the top 50 holders of a BNB Smart Chain ERC-20 token with balances, supply share, concentration metrics, contract/exchange labels, and burned token share.

## Facts

- Endpoint: GET https://chain.intel.rallylive.ca/token/holders/bsc?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-top-holders-bsc-4417ef2a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FLe20Ie5pva6H41E-xaSX

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 token-top-holders-bsc-4417ef2a
```

Example prompt: Who are the top 50 holders of this BSC token at contract 0x2170Ed0880ac9A755fd29B2688956BD959F933F8 — I want to see their balances, what share of supply they hold, whether any are exchanges or contracts, how much has been burned, and the concentration breakdown for top 1, 5, 10, and 20 holders.

## When to prefer this

Choose this endpoint when you need on-chain holder distribution analysis specifically for a BNB Smart Chain token — particularly when evaluating whale concentration, insider risk, burned supply, or whether major holders are exchanges or contracts. Prefer this over generic token price or liquidity endpoints when your goal is supply concentration analysis or token safety due diligence on BSC. Use the Ethereum or Polygon equivalents for those chains.

## Known failure modes

- Invalid or non-existent contract address returns an error or empty result
- Non-BSC contract addresses (e.g. Ethereum or Polygon) will not return valid data
- Token with no on-chain holder data may return empty list
- Rate limiting or payment failure (x402) if USDC payment is not processed
- Newly launched tokens with very few holders may return incomplete concentration data

## How this service works

BNB Smart Chain: Top 50 holders of a token with share of supply, balances, contract/exchange labels, burned share and concentration (top 1/5/10/20). Spot whale-controlled and insider-heavy tokens. $0.03 per call.

## Output

Returns a ranked list of the top 50 holders of the specified BSC token, including each holder's address, token balance, percentage share of total supply, and labels indicating whether the address is a contract, exchange, or known entity. Also includes aggregate concentration metrics (share held by top 1, 5, 10, and 20 holders), the percentage of supply held in burn addresses, and an overall supply distribution picture useful for spotting whale-dominated or insider-heavy tokens.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-top-holders-bsc-4417ef2a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chain.intel.rallylive.ca](https://www.zero.xyz/host/chain.intel.rallylive.ca/llms.txt)