{"uid":"cap_9Y2ZRtDhQ_5kkXTST3jSx","slug":"vybe-solana-token-top-holders-a477364f","name":"Vybe Solana Token Top Holders","description":"Read access to Solana on-chain data — tokens, wallets, markets, prices, trades, transfers. No API key, no signup. Pay in USDC per request with the x402 protocol; the per-route price is declared in `x-payment-info`. WebSocket streaming uses prepaid credits.","url":"https://x402-api.vybenetwork.xyz/v4/tokens/%7BmintAddress%7D/top-holders?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["mintAddress"],"properties":{"page":{"type":"integer","description":"Page selection, 0-indexed."},"limit":{"type":"integer","description":"Limit of the number of transfers to return per page. Default/max is 1000."},"sortByAsc":{"type":"string","description":"Sort ascending by 'rank', 'ownerName', 'ownerAddress', 'valueUsd', 'balance' or 'percentageOfSupplyHeld'. Only one of sort_by_asc or sort_by_desc can be used"},"sortByDesc":{"type":"string","description":"Sort descending by 'rank', 'ownerName', 'ownerAddress', 'valueUsd', 'balance' or 'percentageOfSupplyHeld'. Only one of sort_by_asc or sort_by_desc can be used"},"mintAddress":{"type":"string","description":"The public key of the token of interest"}}},"responseSchema":{"$ref":"#/components/schemas/TopHoldersReturn"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.024","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.024/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.024","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.024","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0kvPl94xonjWW8NuUaEq-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.024","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked, paginated list of the largest holders of a given Solana SPL token, including balances, USD values, and supply percentages.","exampleAgentPrompt":"Show me the top 50 holders of the Solana token with mint address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v, sorted descending by percentage of supply held.","exampleUseCases":null,"resultDescription":"A paginated list of top token holders including each holder's rank, wallet address, optional owner name, token balance, USD value of holdings, and percentage of total token supply held. Results can be sorted ascending or descending by rank, name, address, USD value, balance, or supply percentage.","failureModes":["Invalid or non-existent mintAddress returns 404 or empty result","Payment not included or insufficient USDC triggers 402 Payment Required with x-payment-info header","Conflicting sortByAsc and sortByDesc parameters returns 400 Bad Request","Page index out of range returns empty results or 400","Rate limiting or network error returns 5xx"],"whenToPreferThis":"Use this endpoint when you need on-chain token holder distribution data for a specific Solana SPL token — particularly for whale analysis, concentration risk assessment, or identifying major stakeholders. Prefer this over generic blockchain explorers when you need structured, sortable, paginated data with USD valuations, accessible without API key signup via micropayment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:40:59.091Z","isFirstParty":false,"canonicalSlug":"vybe-solana-token-top-holders-a477364f"}