{"uid":"cap_EKPxMODFSYPE0ewQlUvBP","slug":"holder-check-fd7d5162","name":"holder-check","description":"Holder Analysis API for Base tokens: top 10 holders with % and type (wallet, contract, LP pool, burn), wallet-only concentration, distribution verdict and bundling check from real on-chain data. $0.02 per call via x402 (USDC on Base). Not investment advice.","url":"https://holder-check.restockalarm.workers.dev/v1/holders?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 contract address on Base (0x + 40 hex). If omitted, the AERO example is returned with example=true; an invalid address is 400."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"base","token":{"name":"Degen","symbol":"DEGEN"},"top10":[{"pct":22.61,"type":"wallet","address":"0x06A19654e0872Ba71c2261EA691Ecf8a0c677156"}],"cached":false,"method":"…","address":"0x4ed4e862860bed51a9570b96d89af5e1b0efefed","sources":["https://api.honeypot.is/v1/TopHolders?…"],"bundling":{"status":"ingen tegn","evidence":[],"status_en":"none","checks_run":["equal_share_check","same_block_check"]},"disclaimer":"Ikke investeringsråd / not investment advice. Automated analysis of public on-chain data; labels and bundling hints can be wrong or incomplete. Do your own research.","distribution":"koncentreret","total_holders":1192880,"distribution_en":"concentrated","top10_total_pct":58.4,"top10_wallets_pct":40.1,"signals_measured_list":["top_holders","holder_types","equal_share_check","same_block_check"]}},"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_4iUshwVKd8-gT1n81i0cN","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 top-10 holder breakdown, wallet-only concentration, distribution verdict, and bundling check for any ERC-20 token on Base from live on-chain data.","exampleAgentPrompt":"Can you analyze the holder distribution for the token at 0x4ed4e862860bed51a9570b96d89af5e1b0efefed on Base? I want to see the top 10 holders, what type they are (wallet, LP, contract, burn), the wallet-only concentration, and whether there are any bundling red flags.","exampleUseCases":[{"title":"Pre-investment token risk check","prompt":"Before I buy into this Base token at 0x6921b130d297cc43754afba22e5eac0fbf8db75b, can you pull up the top 10 holders and tell me if it looks concentrated or if there are any bundling signals I should worry about?"},{"title":"Meme coin launch safety audit","prompt":"I'm looking at a new meme coin on Base — contract 0x4ed4e862860bed51a9570b96d89af5e1b0efefed. Can you check whether the top holders are mostly wallets or contracts, what percentage the top 10 control, and if the distribution looks healthy or concentrated?"},{"title":"DeFi due diligence on token treasury","prompt":"We're considering adding 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 to our liquidity pool. Can you run a holder analysis and flag if there are any LP pool or burn address distortions in the top 10, and what the wallet-only concentration looks like?"}],"resultDescription":"Returns a JSON object with: token name and symbol, list of top 10 holders each with address, percentage held, and classified type (wallet, contract, LP pool, or burn address), total holder count, top-10 combined percentage, wallet-only top-10 percentage, a distribution verdict in English (e.g. 'concentrated' or 'distributed'), a bundling check result with status and evidence array, data sources used, and a disclaimer. Optionally indicates if result was served from cache.","failureModes":["Invalid or malformed address (not 0x + 40 hex) returns HTTP 400","Omitting the address parameter returns an example response with example=true flag","On-chain data provider unavailable may cause lookup failure or stale data","Token with very few on-chain interactions may return incomplete holder data","Payment not completed via x402 returns 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need on-chain holder concentration and bundling analysis specifically for ERC-20 tokens deployed on the Base chain. It is purpose-built for token risk screening with labeled holder types (wallet vs LP vs contract vs burn) and coordinated-buying detection, making it more actionable than generic blockchain explorers. Prefer it over manual Etherscan inspection or general-purpose RPC calls when you need a structured, agent-friendly verdict on token distribution.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T06:39:49.389Z","isFirstParty":false,"canonicalSlug":"holder-check-fd7d5162"}