{"uid":"cap_Yt7fWGrWfG-aDj1fjW9uF","slug":"halowerk-kettenwerk-erc-20-token-holder-lookup-6921d833","name":"HALOWERK kettenwerk — ERC-20 Token Holder Lookup","description":"HALOWERK kettenwerk — bezahlte Endpunkte nach x402. Preise in USDC auf Base Mainnet.","url":"https://kette.netzhandwerker.de/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_r51jcPUGtJOfJPOR1mtW-","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":"Returns the top N holders of a given ERC-20 token on a specified EVM-compatible chain","exampleAgentPrompt":"Who are the top 20 holders of the USDC token (contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) on Ethereum?","exampleUseCases":[{"title":"Whale concentration check for new token","prompt":"Can you pull the top 50 holders of the token at 0x6982508145454ce325ddbe47a25d4ec3d2311933 on Ethereum so I can see if any whales are dominating the supply?"},{"title":"DeFi project due diligence on Base","prompt":"I'm evaluating a project on Base — can you get the top 20 holders of their token at 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 so I can check how decentralized the ownership is?"},{"title":"Arbitrum token holder monitoring","prompt":"Fetch the top 30 holders of the token 0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8 on Arbitrum so I can track if any major wallets have changed their positions."}],"resultDescription":"A ranked list of up to 100 wallet addresses that hold the most of the specified ERC-20 token on the given chain, including their balances or share of supply, ordered from largest to smallest holder.","failureModes":["Invalid or non-ERC-20 contract address returns an error","Unsupported chain identifier causes a bad request response","top_n value outside the 10–100 range is rejected","Contract address not found on the specified chain returns empty or error","Payment failure via x402 protocol blocks the request"],"whenToPreferThis":"Choose this endpoint when you need on-chain holder distribution data for any ERC-20 token across major EVM chains (Ethereum, Base, Arbitrum, Optimism) and want a ranked list of top wallets. It is ideal for DeFi due diligence, whale tracking, and token concentration analysis. Prefer this over generic blockchain explorers when you need programmatic, structured holder data payable via x402 microtransaction.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:39:19.326Z","isFirstParty":false}