# Agent402 Solana Token Holders

> Agent402 Solana Token Holders is a paid API for AI agents from agent402.tools, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns the top holders, concentration metrics, and supply details for any SPL token on Solana given its mint address.

## Facts

- Endpoint: POST https://agent402.tools/api/sol-token-holders
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-solana-token-holders-4697161c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rOy4G6W3-NG9QEVnC7EIN

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 agent402-solana-token-holders-4697161c -d '<json body>'
```

Example prompt: Who are the top 10 holders of the JUP token on Solana (mint address JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN), and what percentage of supply do they control?

## When to prefer this

Use this endpoint when you need on-chain Solana token holder distribution data including concentration metrics and insider flags, especially for DeFi risk screening, token due diligence, or whale-watch monitoring. It draws from rugcheck, making it particularly useful for rug-pull detection workflows. Prefer it over generic blockchain RPC calls when you need pre-aggregated concentration statistics without building your own holder indexer.

## Known failure modes

- Invalid or non-existent mint address returns an error or empty result
- Limit out of range (outside 1-20) may return a validation error
- Rugcheck data source may lag behind very recent token launches
- Network or upstream API timeout from rugcheck data provider
- Payment failure (insufficient USDC) prevents the call from completing

## How this service works

Top-holder concentration for a Solana token mint: the 20 largest holders with token account, owner wallet, balance, percent of supply, insider flag and a pool/locker label when the account is a known AMM vault or locker, plus top-1/5/10/20 share, top-10 share excluding labelled pool accounts, insider count, total holder count and supply. Use it to tell a whale-held launch from one whose largest holder is the liquidity pool.

## Output

Returns a JSON object containing the token symbol, total supply, decimals, total holder count, a list of up to 20 top holders (each with wallet address, token account, UI amount, percentage of supply, label if known, and insider flag), concentration statistics (top 1/5/10/20 percentages, insider holder count, labeled pool/locker accounts), the data source (rugcheck), and the timestamp of when the data was fetched.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mint": {
   "type": "string",
   "description": "Base58 SPL token mint address."
  },
  "limit": {
   "type": "number",
   "description": "Holders to return (1-20, default 20)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mint": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  "source": "rugcheck",
  "supply": 6862431164.93,
  "symbol": "JUP",
  "holders": [
   {
    "pct": 24.77,
    "label": null,
    "owner": "EXJH...",
    "insider": false,
    "uiAmount": 1700000000.1,
    "tokenAccount": "6G4X..."
   }
  ],
  "decimals": 6,
  "fetchedAt": "2026-08-22T12:00:00.000Z",
  "totalHolders": 2873512,
  "concentration": {
   "top1Pct": 24.77,
   "top5Pct": 57.67,
   "top10Pct": 66.1,
   "top20Pct": 75.2,
   "insiderHolders": 0,
   "top10PctExcludingPools": 66.1,
   "labeledPoolOrLockerAccounts": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-solana-token-holders-4697161c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)