# token-top-holders-polygon

> token-top-holders-polygon 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 Polygon PoS ERC-20 token, including supply share, balances, contract/exchange labels, burned share, and concentration metrics.

## Facts

- Endpoint: GET https://chain.intel.rallylive.ca/token/holders/polygon?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-polygon-885ca4d1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5mdpJnfejMSHGy92MWHVc

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-polygon-885ca4d1
```

Example prompt: Who are the top 50 holders of the Polygon token at contract 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174, and how concentrated is the supply — what share do the top 10 wallets control?

## When to prefer this

Use this endpoint when you need holder distribution and concentration data specifically on Polygon PoS — for due diligence on token investments, spotting whale risk, identifying insider accumulation, or auditing supply fairness. Prefer this over BSC or other chain variants when the token is deployed on Polygon. Pair with honeypot-check-polygon and token-security-scan for a full token risk profile.

## Known failure modes

- Invalid or non-existent contract address returns an error or empty holder list
- Token with no on-chain DEX or holder data may return incomplete results
- Rate limiting or payment failure (x402) if USDC payment of $0.03 is not completed
- Newly deployed tokens with very few transactions may have sparse holder data
- Non-ERC-20 or non-Polygon contract addresses will fail or return unexpected results

## How this service works

Polygon PoS: 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 list of up to 50 top token holders on Polygon PoS with each holder's address, balance, percentage of total supply, and labels indicating whether the address is a contract, exchange, or other known entity. Also includes the share of supply held by burned addresses and concentration scores for the top 1, 5, 10, and 20 holders.

## 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-polygon-885ca4d1/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)