{"uid":"cap_0sbImBu2X6XCV8z43tH6O","slug":"halowerk-kettenwerk-token-holder-concentration-analyzer-ccf93068","name":"HALOWERK kettenwerk Token Holder Concentration Analyzer","description":"Reads the holder list of an ERC-20 token from a public block explorer index and reports concentration. Addresses that do not represent a person or entity - liquidity pools, bridges, burn addresses and exchange custody - are excluded from the adjusted figure and every exclusion is listed with its evidence. The raw top-10 share is reported alongside so both numbers can be compared. Labels are only set when they can be backed by on-chain code or a public tag; otherwise the label is \"unbekannt\". Lim","url":"https://kette.halowerk.com/token/holders","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string","description":"Chain identifier, for example ethereum, base, arbitrum or optimism."},"token":{"type":"string","description":"ERC-20 contract address, 0x followed by 40 hex characters."},"top_n":{"type":"integer","default":20,"maximum":100,"minimum":10,"description":"How many holders to examine. Default 20."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BgphSRT_HFWw6Ekim6FZT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reads the top holder list of an ERC-20 token from a block explorer, filters out non-human addresses (LPs, bridges, burn addresses, exchange custody), and reports both raw and adjusted holder concentration with labeled evidence for each exclusion.","exampleAgentPrompt":"Can you check the holder concentration for the USDC token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum, looking at the top 50 holders, and tell me what the adjusted concentration looks like after excluding liquidity pools and exchange wallets?","exampleUseCases":[{"title":"Pre-investment whale risk check","prompt":"Before I buy into this new token on Base at 0x4200000000000000000000000000000000000006, can you check the top 20 holders and give me the adjusted concentration after removing any LPs, bridges, or exchange wallets? I want to know if whales dominate."},{"title":"DeFi protocol token audit","prompt":"I'm reviewing the governance token for a DeFi protocol on Arbitrum — contract 0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8. Can you pull the top 30 holders and show me the real distribution excluding any non-person addresses, with evidence for each exclusion?"},{"title":"Token decentralization comparison","prompt":"Compare the adjusted holder concentration for this Optimism token at 0x4200000000000000000000000000000000000042 across the top 100 holders — show me both the raw top-10 share and the cleaned-up number so I can see how much the LPs and burn addresses are distorting it."}],"resultDescription":"Returns the raw top-N holder share percentage alongside an adjusted concentration figure that excludes non-person addresses such as liquidity pools, bridges, burn addresses, and exchange custody wallets. Each excluded address is listed with its label and the on-chain or public-tag evidence backing that label. Addresses that cannot be verified are labeled 'unbekannt' (unknown).","failureModes":["Invalid or non-ERC-20 contract address returns an error or empty holder list","Unsupported chain identifier causes a chain-not-found error","Block explorer rate limits or outages result in incomplete data","top_n below 10 or above 100 is rejected by schema validation","Some addresses may be labeled 'unbekannt' if no on-chain code or public tag can verify them","Token with very few holders may produce unreliable concentration statistics"],"whenToPreferThis":"Choose this endpoint when you need a nuanced, evidence-backed holder concentration analysis that distinguishes between real human/entity holders and protocol-owned addresses like LPs and bridges. Prefer it over raw block explorer queries when you need both raw and adjusted figures for comparison, or when you need every exclusion justified with on-chain evidence. Especially useful for due diligence on new or unfamiliar tokens where whale risk and decentralization matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T12:38:06.940Z","isFirstParty":false}