# Solana Token Holder Distribution Lookup

> Solana Token Holder Distribution Lookup is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns the top holders of a Solana SPL token by mint address, including rank, wallet address, token account, amount held, and percentage of total supply.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/solana/holders/%7Bmint%7D
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/solana-token-holder-distribution-lookup-2cdd7d1f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__EqcD4YOorH2XDErz6oNM

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 solana-token-holder-distribution-lookup-2cdd7d1f
```

Example prompt: Who are the top holders of the Solana token with mint address 27G8MtK7VtTcCHkpASjSDdkWWYfoqT6ggEuKidVJidD4 — show me their wallet addresses, how much they hold, and their percentage of total supply.

## When to prefer this

Use this endpoint when you need on-chain Solana token holder distribution data — specifically top wallet rankings, concentration metrics, and supply percentages — for any SPL token identified by its mint address. Prefer this over general crypto APIs when the token is Solana-native and you need wallet-level granularity rather than just price or volume data.

## Known failure modes

- Invalid or unrecognized mint address returns an error or empty holder list
- Mint address for a token with very few on-chain records may return minimal data
- Payment failure via x402/USDC results in 402 Payment Required response
- Malformed mint address format causes a 400 Bad Request
- Rate limiting or network issues on Solana RPC may cause delayed or failed responses

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

Returns a ranked list of top token holders for the specified Solana mint, each with owner wallet address, associated token account, amount held, and percent of total supply. Also includes total holder count and total supply, along with the token symbol and data timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "mint": "27G8MtK7VtTcCHkpASjSDdkWWYfoqT6ggEuKidVJidD4",
   "symbol": "JLP",
   "holders": [
    {
     "rank": 1,
     "owner": "9RfZwn2Prux6QesG1Noo4HzMEBv3rPndJ2bN2Wwd6a7p",
     "amount": 12500000,
     "token_account": "FgpXg2J3TzSs7w3WGYYE7aWePdrxBVLCXSxmAKnCZNtZ",
     "percent_of_supply": 5.6577
    },
    {
     "rank": 2,
     "owner": "5BUwFW4nRbftYTDMbgxykoFWqWHPzahFSNAaaaJtVKsq",
     "amount": 8000000,
     "token_account": "WzWUoCmtVv7eqAbU3BfKPU3fhLP6CXR8NCJH78UK9VS",
     "percent_of_supply": 3.6209
    }
   ],
   "holder_count": 2,
   "total_supply": 220936259.555971
  },
  "as_of": "2026-06-08T00:00:00.000Z",
  "venue": "solana",
  "source": "x402stock"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/solana-token-holder-distribution-lookup-2cdd7d1f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)