# token-top-holders-arbitrum

> token-top-holders-arbitrum 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 token holders on Arbitrum One with supply share, balances, contract/exchange labels, burned share, and concentration metrics (top 1/5/10/20).

## Facts

- Endpoint: GET https://chain.intel.rallylive.ca/token/holders/arbitrum?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-arbitrum-c79bf629
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_56o9pS-5i7oyVrlSzEvrf

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-arbitrum-c79bf629
```

Example prompt: Can you check who the top 50 holders of the token at 0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9 are on Arbitrum, and tell me how concentrated the supply is — specifically how much the top 10 wallets control and whether any are labeled exchanges or insiders?

## When to prefer this

Choose this endpoint when you need detailed holder distribution and concentration data specifically on Arbitrum One — especially to detect whale dominance, insider heavy tokens, or assess decentralization risk before investing or listing a token. It is more granular than a simple security scan, providing ranked individual wallets with labels rather than just a pass/fail verdict.

## Known failure modes

- Invalid or non-ERC-20 contract address returns an error or empty result
- Token with very few holders may return fewer than 50 entries
- Contract not yet indexed on Arbitrum One may return no data
- Network timeouts if the on-chain data provider is temporarily unavailable
- Payment failure (x402) if the $0.03 USDC fee is not correctly handled

## How this service works

Arbitrum One: 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 holder addresses for the specified Arbitrum ERC-20 token, each annotated with their balance, percentage share of total supply, and a label (e.g. exchange, contract, burn address). Also includes aggregated concentration metrics showing the cumulative supply share held by the top 1, 5, 10, and 20 holders, as well as the total burned token share.

## 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-arbitrum-c79bf629/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)