{"uid":"cap_QaP46SIC1DTRSu7nJQNd5","slug":"solmachina-token-holder-distribution-a9d753af","name":"SolMachina Token Holder Distribution","description":"Before an AI agent executes on Solana, it asks SolMachina: risk + a decision (EXECUTE/REVIEW/REJECT) + an SMRI score + a signed receipt, paid per call over x402 in USDC. Trust-first — cites every source, says 'unknown' over guessing. No account, no API key.","url":"https://api.solmachina.com/v1/token-holders","method":"GET","headers":{},"bodySchema":{"type":"object","required":["mint"],"properties":{"mint":{"type":"string","description":"Base58 SPL token mint address, e.g. DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 (BONK). Major stablecoins like USDC have too many accounts to snapshot."}}},"responseSchema":{"type":"object","properties":{"supply":{"type":"object","properties":{"decimals":{"type":"integer"},"uiAmount":{"type":"integer"}}},"buckets":{"type":"object","properties":{"gt5pct":{"type":"integer"},"lt1pct":{"type":"integer"},"unknown":{"type":"integer"},"from1to5pct":{"type":"integer"}}},"concentration":{"type":"object","properties":{"band":{"type":"string"},"top1Pct":{"type":"number"},"top10Pct":{"type":"number"}}},"largestAccounts":{"type":"object","properties":{"limit":{"type":"integer"},"returned":{"type":"integer"}}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZyJEHlyobBj2UEYgteb-T","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns supply details, concentration metrics, and largest account breakdown for a Solana SPL token given its mint address.","exampleAgentPrompt":"What does the holder distribution look like for BONK — specifically how concentrated is it, what percentage does the top 1% and top 10% hold, and how many wallets hold over 5% of supply? The mint address is DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263.","exampleUseCases":[{"title":"Pre-trade whale risk check","prompt":"Before I buy into this Solana token with mint 7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr, can you pull the holder distribution and tell me if any single wallet holds more than 5% of supply — I want to know the whale risk."},{"title":"DeFi protocol decentralization audit","prompt":"I'm evaluating the governance token for a Solana DeFi protocol — mint address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v. Can you check how decentralized the supply actually is, including what the top 1% and top 10% of holders control?"},{"title":"Memecoin rug-pull signal detection","prompt":"Someone is shilling this new Solana memecoin with mint address So11111111111111111111111111111111111111112 — can you snapshot the token holder distribution right now and flag if the concentration looks suspicious or like a potential rug pull?"}],"resultDescription":"Returns a JSON object with: token supply (raw and UI amount with decimals), holder concentration buckets (number of wallets holding >5%, 1-5%, <1%, or unknown share of supply), concentration metrics (band label, top-1% share, top-10% share), and largest accounts metadata (limit queried, count returned).","failureModes":["Invalid or non-existent mint address returns an error or empty result","USDC and other major stablecoins with millions of holders may time out or be explicitly rejected","Network congestion on Solana RPC may delay or fail the snapshot","Payment failure via x402/USDC will block the request from being processed","Mint addresses for tokens with very low liquidity may return incomplete bucket data"],"whenToPreferThis":"Use this endpoint when you need on-chain token holder concentration data for a specific Solana SPL token — particularly for risk assessment before a trade, rug-pull screening, or decentralization audits. It is purpose-built for Solana (not EVM chains) and returns pre-computed concentration buckets and percentages rather than raw account lists. Prefer it over general blockchain explorers when you need structured, machine-readable concentration metrics in a single API call paid per-use with no account setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:37:21.088Z","isFirstParty":false}