{"uid":"cap_6ffGcBSHBQ6_Hr2LuzVj5","slug":"x402-trading-hub-holder-distribution-bb20a7dd","name":"x402 Trading Hub - Holder Distribution","description":"67 paid endpoints for on-chain, forex, stocks & market intelligence","url":"https://trading-hub-v4-omega.vercel.app/api/holder/distribution?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object"},"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_BmVbf1PYsZabnhw4qxYqC","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 an on-chain asset, showing how holdings are spread across wallet tiers","exampleAgentPrompt":"Can you pull the holder distribution for the token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — I want to see how ownership is spread across wallet tiers?","exampleUseCases":[{"title":"Whale concentration risk check","prompt":"Show me the holder distribution for the token at 0xdAC17F958D2ee523a2206206994597C13D831ec7 on Ethereum — I want to know if the top 10 wallets control most of the supply."},{"title":"DeFi project due diligence","prompt":"Before I invest, can you analyze the holder distribution for this DeFi token at contract 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 so I can see if it's fairly distributed or concentrated in a few hands?"},{"title":"Token launch distribution audit","prompt":"We just launched our token and I want to verify the holder distribution looks healthy — can you pull the breakdown for contract 0x6B175474E89094C44Da98b954EedeAC495271d0F and show me the wallet tier percentages?"}],"resultDescription":"Returns a structured breakdown of token holders segmented into tiers (e.g. whales, mid-tier, retail) with counts, wallet addresses optionally, percentage of supply held per tier, and concentration metrics such as Gini coefficient or top-N holder share.","failureModes":["Invalid or unrecognized contract address returns an error","Unsupported blockchain network returns a 400 or 422 error","Token with no on-chain holder data returns empty results","Rate limiting or payment failure via x402 protocol returns 402","Very new token contracts may have incomplete holder data"],"whenToPreferThis":"Use this endpoint when you need on-chain token holder distribution data segmented by wallet tier. Prefer this over generic blockchain explorers when you need structured, analysis-ready distribution metrics rather than raw transaction data. Ideal for DeFi due diligence, tokenomics audits, and whale concentration analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-06T12:30:58.748Z","isFirstParty":false,"canonicalSlug":"x402-trading-hub-holder-distribution-bb20a7dd"}