Agent402 / tools / sol-token-holders

Solana token holder concentration

$0.005 per call · USDC via x402 · POST /api/sol-token-holders

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. Read from RugCheck's public report (the public Solana RPC throttles getTokenLargestAccounts).

TRY IN PLAYGROUND →

Input

FieldTypeDescription
mint *stringBase58 SPL token mint address.
limitnumberHolders to return (1-20, default 20).

Example output

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

Try it - see the 402 challenge (free)

curl -i -X POST https://agent402.tools/api/sol-token-holders \
  -H "Content-Type: application/json" \
  -d '{"mint":"JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN","limit":10}'

The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/sol-token-holders", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "mint": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
    "limit": 10
  }),
});
Wallet-only. This tool reaches the network/browser/storage, so it is paid in USDC via x402 (no proof-of-work tier).

Related tools

Crypto order book

$0.003 · GET /api/crypto-orderbook

L2 order-book snapshot for a spot pair: best bid/ask, mid price, spread (absolute + %), and the top N aggregated price l…

try in playground →

Stablecoin peg monitor

$0.003 · GET /api/stablecoin-peg

Live $1-peg deviation for the top USD stablecoins (USDT, USDC, USDS, DAI, USDe, PYUSD, USDD, TUSD, FDUSD by default, or …

try in playground →

Wallet balance (native + ERC-20)

$0.002 · POST /api/wallet-balance

Look up the native coin balance (ETH/MATIC) plus every ERC-20 holding for a wallet address on Ethereum, Base, Polygon, A…

try in playground →