{"uid":"cap_Zvl9lZ52NGP9N8-LG6Kkb","slug":"x402-chain-intel-holder-concentration-b91aabdd","name":"x402 Chain Intel – Holder Concentration","description":"27 paid endpoints for trading bots","url":"https://x402-chain-intel.vercel.app/api/holder/concentration","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.14","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.14/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.14","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.14","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OE4_-lfuvAxVAZvCaUS4v","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.14","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns holder concentration metrics for a given on-chain token, revealing how ownership is distributed across wallets","exampleAgentPrompt":"What's the holder concentration for the token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — I want to know what percentage of supply the top wallets control before I place a trade.","exampleUseCases":[{"title":"Pre-trade rug pull risk check","prompt":"Before my bot buys into this new token at 0x1234abcd... on Ethereum, can you pull the holder concentration data so I can see if a few whales own the majority of the supply?"},{"title":"Token decentralization scoring","prompt":"I'm evaluating a list of DeFi tokens for my portfolio — start with 0xdAC17F958D2ee523a2206206994597C13D831ec7 on Ethereum and tell me how concentrated the holder base is."},{"title":"Whale dominance alert for trading bot","prompt":"My trading bot needs to flag any token where the top 10 holders control more than 60% of supply — run a holder concentration check on contract 0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE8 on Ethereum."}],"resultDescription":"Returns on-chain holder concentration metrics for the specified token, including the share of supply held by top N wallets, distribution statistics (such as a Gini coefficient or HHI), whale wallet addresses and their holdings, and an overall concentration risk signal useful for trading decisions.","failureModes":["Invalid or unrecognized contract address returns an error or empty result","Unsupported blockchain network causes a 400 or 422 error","Token with very low holder count may return incomplete distribution data","Payment of 0.14 USDC not fulfilled causes 402 Payment Required","Rate limiting or provider downtime returns 429 or 503","Newly deployed contracts with no indexed holder data may return null metrics"],"whenToPreferThis":"Choose this endpoint when you need on-chain holder concentration data specifically for trading bot decision-making, risk scoring, or whale detection — particularly when you need a paid, reliable signal with x402 micropayment access rather than scraping free explorers. Prefer this over generic block explorers when you need structured, machine-readable concentration metrics ready for algorithmic consumption.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:56:45.382Z","isFirstParty":false}