# x402stock Solana SPL Token Top Holders

> x402stock Solana SPL Token Top Holders is a paid API for AI agents from agents.x402stock.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-20).

Returns the top holders (up to 20) of any Solana SPL token by balance, including token account, owner wallet, balance, and percentage of total supply, read directly from the public ledger.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/solana/holders/:mint?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-solana-spl-token-top-holders-a7a450d4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iKzVzkLu7v6GiYn83ZImO

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 x402stock-solana-spl-token-top-holders-a7a450d4
```

Example prompt: Show me the top 20 holders of the JUP token on Solana, including each wallet address, their balance, and what share of the total supply they control.

## When to prefer this

Use this endpoint when you need on-chain, ledger-sourced holder data for a Solana SPL token — especially for whale analysis, holder concentration risk, or governance power mapping. Prefer this over Jupiter API-based approaches when you want raw holder rankings not filtered by Jupiter's liquidity data. Best for DeFi due diligence, tokenomics research, or monitoring whether a small group controls a large share of supply.

## Known failure modes

- Invalid or unrecognized mint address returns an error or empty result
- Unknown token symbol (not in the known-symbol list) may fail if base58 mint is not provided
- Limit above 20 is capped or rejected
- Network timeouts or Solana RPC unavailability may cause delays or failures
- Newly minted tokens with no holders may return an empty list

## How this service works

The largest holders of any Solana SPL token (top accounts by balance, up to 20), each with its token account, owner wallet, balance, and share of total supply — for holder-concentration and whale analysis. Pass a base58 mint or a known symbol (JUP, JLP, …); tune with `?limit=` (max 20). Read from the public ledger, no Jupiter API. From x402stock, a market & economic data API (x402, USDC).

## Output

Returns a ranked list of up to 20 token accounts holding the largest balances of the specified SPL token. Each entry includes the token account address, the owner wallet (pubkey), the raw token balance, and that holder's percentage share of the total circulating supply. Data is read directly from the Solana public ledger.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "mint": {
      "type": "string"
     },
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

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