# Solana SPL Token Top Holders

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

Returns the top 20 largest holders of any Solana SPL token, with each holder's token account, owner wallet, balance, and percentage of total supply.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/solana/holders/{mint}?utm_source=zero.xyz
- Price: $0.02/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-05
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-solana-spl-token-top-holders-f326a1e2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UjOGO2uUCTHNSawvyo9R8

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 agents-x402stock-xyz-solana-spl-token-top-holders-f326a1e2
```

Example prompt: Can you pull the top 20 holders of the JUP token on Solana and show me how much of the total supply each one controls?

## When to prefer this

Use this endpoint when you need on-chain holder-concentration data for any Solana SPL token — especially for whale analysis, rug-pull risk assessment, or governance concentration checks. It reads directly from the public Solana ledger (not Jupiter API), so it works for any SPL token by mint address or known symbol. Prefer this over general crypto APIs when you specifically need ranked wallet-level ownership data for Solana tokens.

## Known failure modes

- Invalid or unrecognized mint address returns an error
- Unknown token symbol not resolvable to a mint returns an error
- Limit parameter above 20 is clamped or rejected
- Token with zero holders or very new token may return empty holders array
- Network or ledger read failures may cause transient errors
- total_supply or percent_of_supply may be null for tokens with unavailable supply data

## How this service works

Returns top holders of any Solana SPL token.

## Output

Returns a JSON object with the token mint, symbol, total supply, number of top holders returned, and an array of up to 20 holder records. Each holder record includes their rank, SPL token account address, owner wallet address, raw token balance, and percentage of total supply held. Also includes a timestamp (as_of) and venue identifier.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "mint"
 ],
 "properties": {
  "mint": {
   "type": "string",
   "description": "Solana SPL token mint address (base58)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source",
  "as_of",
  "venue",
  "data"
 ],
 "properties": {
  "data": {
   "type": "object",
   "required": [
    "mint",
    "symbol",
    "total_supply",
    "holder_count",
    "holders"
   ],
   "properties": {
    "mint": {
     "type": "string"
    },
    "symbol": {
     "anyOf": [
      {
       "type": "string"
      },
      {
       "type": "null"
      }
     ]
    },
    "holders": {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "rank",
       "token_account",
       "owner",
       "amount",
       "percent_of_supply"
      ],
      "properties": {
       "rank": {
        "type": "number"
       },
       "owner": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ],
        "description": "The wallet that owns this token account."
       },
       "amount": {
        "anyOf": [
         {
          "type": "number"
         },
         {
          "type": "null"
         }
        ]
       },
       "token_account": {
        "type": "string",
        "description": "The SPL token account (not necessarily the owner wallet)."
       },
       "percent_of_supply": {
        "anyOf": [
         {
          "type": "number"
         },
         {
          "type": "null"
         }
        ]
       }
      },
      "additionalProperties": false
     }
    },
    "holder_count": {
     "type": "number",
     "description": "Number of top accounts returned (max 20)."
    },
    "total_supply": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    }
   },
   "additionalProperties": false
  },
  "as_of": {
   "type": "string"
  },
  "venue": {
   "type": "string",
   "const": "solana"
  },
  "source": {
   "type": "string",
   "const": "x402stock"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-solana-spl-token-top-holders-f326a1e2/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)