# Vybe Solana Token Top Holders

> Vybe Solana Token Top Holders is a paid API for AI agents from x402-api.vybenetwork.xyz, paid per call via x402, $0.024/call, status unknown (last checked 2026-10-12).

Returns a ranked, paginated list of the largest holders of a given Solana SPL token, including balances, USD values, and supply percentages.

## Facts

- Endpoint: POST https://x402-api.vybenetwork.xyz/v4/tokens/%7BmintAddress%7D/top-holders?utm_source=zero.xyz
- Price: $0.024/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vybe-solana-token-top-holders-a477364f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9Y2ZRtDhQ_5kkXTST3jSx

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 vybe-solana-token-top-holders-a477364f -d '<json body>'
```

Example prompt: Show me the top 50 holders of the Solana token with mint address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v, sorted descending by percentage of supply held.

## When to prefer this

Use this endpoint when you need on-chain token holder distribution data for a specific Solana SPL token — particularly for whale analysis, concentration risk assessment, or identifying major stakeholders. Prefer this over generic blockchain explorers when you need structured, sortable, paginated data with USD valuations, accessible without API key signup via micropayment.

## Known failure modes

- Invalid or non-existent mintAddress returns 404 or empty result
- Payment not included or insufficient USDC triggers 402 Payment Required with x-payment-info header
- Conflicting sortByAsc and sortByDesc parameters returns 400 Bad Request
- Page index out of range returns empty results or 400
- Rate limiting or network error returns 5xx

## How this service works

Read access to Solana on-chain data — tokens, wallets, markets, prices, trades, transfers. No API key, no signup. Pay in USDC per request with the x402 protocol; the per-route price is declared in `x-payment-info`. WebSocket streaming uses prepaid credits.

## Output

A paginated list of top token holders including each holder's rank, wallet address, optional owner name, token balance, USD value of holdings, and percentage of total token supply held. Results can be sorted ascending or descending by rank, name, address, USD value, balance, or supply percentage.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "mintAddress"
 ],
 "properties": {
  "page": {
   "type": "integer",
   "description": "Page selection, 0-indexed."
  },
  "limit": {
   "type": "integer",
   "description": "Limit of the number of transfers to return per page. Default/max is 1000."
  },
  "sortByAsc": {
   "type": "string",
   "description": "Sort ascending by 'rank', 'ownerName', 'ownerAddress', 'valueUsd', 'balance' or 'percentageOfSupplyHeld'. Only one of sort_by_asc or sort_by_desc can be used"
  },
  "sortByDesc": {
   "type": "string",
   "description": "Sort descending by 'rank', 'ownerName', 'ownerAddress', 'valueUsd', 'balance' or 'percentageOfSupplyHeld'. Only one of sort_by_asc or sort_by_desc can be used"
  },
  "mintAddress": {
   "type": "string",
   "description": "The public key of the token of interest"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "$ref": "#/components/schemas/TopHoldersReturn"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vybe-solana-token-top-holders-a477364f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-api.vybenetwork.xyz](https://www.zero.xyz/host/x402-api.vybenetwork.xyz/llms.txt)