{"uid":"cap_7abzvtjhXwap6Em_63aMI","slug":"onchainpulse-holder-concentration-map-7fa27262","name":"OnchainPulse Holder Concentration Map","description":"Holder-concentration map for any token — Solana + 8 EVM chains incl. Base & Robinhood Chain: top holders with LP-pool / locker / burn / contract labels, largest-wallet and top-10 share excluding LP & burn, % of supply in LP or lockers, % burned, % sitting in unlabeled contracts, creator & owner balances, insider-cluster detection (Solana). The \"who actually holds this thing\" layer of token due diligence, as observable facts with per-wallet breakdown. Deterministic, sub-second, no LLM.","url":"https://onchainpulse.theaslangroupllc.com/api/holder-map","method":"GET","headers":{},"bodySchema":{"type":"object","required":["address"],"properties":{"chain":{"type":"string","description":"solana or one of: base, ethereum, bsc, arbitrum, polygon, optimism, avalanche, robinhood (default base; solana auto-detected from mint format)"},"address":{"type":"string","description":"Token contract address (0x… EVM) or mint (base58 Solana)"}}},"responseSchema":{"type":"json","example":{"read":"Distribution is broad for a memecoin: top-10 wallets (ex-LP/burn) hold 18.6%.","chain":"base","flags":["Top non-LP wallet holds 4.2% of supply"],"address":"0x532f27101965dd16442E59d40670FaF5eBB142E4","disclaimer":"Holder-distribution facts observed on-chain at a point in time via public data sources. Bucket shares are floors computed from the visible top-holder list, not exhaustive census numbers. Analytics, not financial advice; concentration is a structural observation, not an accusation.","top_holders":[{"pct":5.8,"tag":"Uniswap V3: BRETT","bucket":"lp_or_locked","address":"0x3f6…9a2","is_locked":false,"is_contract":true},{"pct":4.2,"tag":null,"bucket":"wallet","address":"0x91c…44b","is_locked":false,"is_contract":false}],"holder_count":"48213","concentration":{"owner_pct":0,"pct_burned":0,"creator_pct":1.1,"top_holder_pct":4.2,"top10_holder_pct":18.6,"pct_contract_held":2.3,"pct_in_lp_or_locked":6.1}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_M-vwX7tZW8wtFQ1pi4sQq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a detailed holder-concentration breakdown for any token on Solana or 8 EVM chains, with per-wallet labels (LP, locker, burn, contract), top-holder shares, insider-cluster detection, and supply distribution metrics.","exampleAgentPrompt":"Pull the holder concentration map for token 0xabc123 on Base — I want to see the top holders with LP/burn/locker labels, what share the top 10 hold excluding LP and burn, how much is burned, and whether any insider clusters are flagged.","exampleUseCases":[{"title":"Pre-trade whale concentration check","prompt":"Before I ape into this token on Base at address 0xdef456, can you check the holder map and tell me if the top 10 wallets control more than 30% of supply excluding LP and burn, and whether the creator or owner is still sitting on a big bag?"},{"title":"Solana memecoin insider cluster detection","prompt":"I'm looking at this Solana memecoin with mint address XYZ789 — run the holder concentration map and flag any insider clusters you find, and tell me what % of supply is locked versus in unlabeled contracts."},{"title":"Token due diligence supply distribution audit","prompt":"Give me the full holder breakdown for Ethereum token 0xaaa111 — I need the top holders labeled as LP pool, locker, burn, or contract, the largest single wallet share, and what percentage of the supply is burned or locked in liquidity."}],"resultDescription":"Returns a per-wallet breakdown of top holders with labels (LP pool, locker, burn address, smart contract, or EOA), the largest single wallet's share, the top-10 cumulative share excluding LP and burn addresses, percentage of total supply held in LP pools, percentage locked, percentage burned, percentage in unlabeled contracts, creator and owner wallet balances, and on Solana, insider-cluster detection results.","failureModes":["Invalid or unrecognized token contract address returns an error","Unsupported chain identifier returns a chain-not-supported error","Token with no on-chain holder data (e.g. brand new or very low activity) may return sparse results","Network or RPC timeout may cause sub-second SLA to be missed on congested chains","Malformed address format returns a validation error"],"whenToPreferThis":"Choose this endpoint when you need a deterministic, sub-second, labeled breakdown of who actually holds a token — especially for due diligence on whale concentration, insider risk, LP vs locked vs burned supply distribution, or creator/owner exposure. Prefer this over general token-info endpoints when the specific question is holder distribution and supply concentration rather than price, liquidity depth, or contract safety flags. Covers Solana plus 8 EVM chains including Base and Robinhood Chain.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:39:58.346Z","isFirstParty":false}