# token-top-holders-optimism

> token-top-holders-optimism 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 any ERC-20 token on Optimism (OP Mainnet), including supply share, balances, contract/exchange labels, burned share, and concentration metrics.

## Facts

- Endpoint: GET https://chain.intel.rallylive.ca/token/holders/optimism?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-optimism-85ced899
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YgayQ6628XRiy92QbaRKt

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-optimism-85ced899
```

Example prompt: Who are the top 50 holders of the token at 0x4200000000000000000000000000000000000042 on Optimism, and how concentrated is the supply among the top 10 wallets?

## When to prefer this

Use this endpoint when you specifically need holder distribution data for a token deployed on Optimism (OP Mainnet). It is the right choice when evaluating whale risk, insider concentration, token safety from a distribution standpoint, or burned supply on Optimism. Choose sibling endpoints for the same analysis on Polygon, Ethereum, Arbitrum, or other chains.

## Known failure modes

- Invalid or non-existent contract address returns an error or empty holder list
- Token with no on-chain holder data (e.g. newly deployed with no transactions) may return incomplete results
- Network issues or RPC timeouts on Optimism may cause delayed or failed responses
- Non-ERC-20 contracts may return unexpected or malformed data
- Payment failure (x402) if USDC balance is insufficient for the $0.03 fee

## How this service works

OP Mainnet: 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

A ranked list of the top 50 token holders on Optimism with each holder's address, balance, percentage of total supply, and labels (exchange, contract, etc.), plus summary concentration stats for the top 1, 5, 10, and 20 holders and the share of supply that has been burned.

## 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-optimism-85ced899/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)