{"uid":"cap_8ctdrRqulXXwZG3kvSFH8","slug":"x402-chain-intel-holder-distribution-a5150620","name":"x402 Chain Intel – Holder Distribution","description":"27 paid endpoints for trading bots","url":"https://x402-chain-intel.vercel.app/api/holder/distribution","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ibqt2JU5WLIkQEtKU6v3d","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the token holder distribution breakdown for a given on-chain asset, enabling trading bots to assess concentration risk and whale activity.","exampleAgentPrompt":"Show me the holder distribution for the token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — I want to see how concentrated ownership is among the top wallets.","exampleUseCases":[{"title":"Whale concentration risk check","prompt":"Pull the holder distribution for 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum — I need to know what percentage of supply the top 10 wallets control before I open a position."},{"title":"Rug-pull screening for new token","prompt":"Can you check the holder distribution for this new token at 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum? I want to see if one or two wallets are holding most of the supply."},{"title":"Portfolio diversification signal","prompt":"Analyze the holder distribution for the token 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum and tell me how evenly spread the ownership is — is it healthy retail distribution or dominated by a few whales?"}],"resultDescription":"Returns a breakdown of token holders segmented by wallet size tier (e.g. whales, mid-tier, retail), including percentage of supply held by top N wallets, total unique holder count, and concentration metrics useful for assessing risk before trading.","failureModes":["Invalid or unrecognized contract address returns a 400 or empty distribution","Unsupported blockchain network results in an error response","Payment of 0.1 USDC not received via x402 protocol results in 402 Payment Required","Rate limiting or Vercel cold-start may cause intermittent timeouts","Token with very low liquidity or brand-new contract may return incomplete data"],"whenToPreferThis":"Use this endpoint when a trading bot or analyst needs on-chain holder distribution data to assess whale concentration, spot potential rug-pull risk, or evaluate the health of token ownership before executing a trade. Prefer this over generic block explorers when you need structured, machine-readable distribution tiers rather than raw transaction lists.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:41:16.948Z","isFirstParty":false}