{"uid":"cap_UjOGO2uUCTHNSawvyo9R8","slug":"agents-x402stock-xyz-solana-spl-token-top-holders-f326a1e2","name":"Solana SPL Token Top Holders","description":"Returns top holders of any Solana SPL token.","url":"https://agents.x402stock.xyz/api/v1/solana/holders/{mint}?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["mint"],"properties":{"mint":{"type":"string","description":"Solana SPL token mint address (base58)."}}},"responseSchema":{"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},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.02","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zK2ydvp9atsSSJGFlWEwC","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-x402","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Whale concentration check for new token","prompt":"Show me the top 10 holders of this Solana token mint 7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs and what percentage of supply they each hold — I want to know if it's whale-dominated."},{"title":"DeFi token distribution analysis","prompt":"Pull the top 20 wallets holding JLP on Solana and tell me how concentrated the ownership is — what share of total supply is in the top 5 accounts?"},{"title":"Pre-investment holder vetting","prompt":"Before I buy into this Solana token, can you look up the biggest holders for mint address So11111111111111111111111111111111111111112 and flag if any single wallet controls more than 10% of supply?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:40:49.482Z","isFirstParty":false,"canonicalSlug":"agents-x402stock-xyz-solana-spl-token-top-holders-f326a1e2"}