{"uid":"cap_E1gHVbf-hUt_T7yFJ4xuI","slug":"holder-forensics-51b9a3ee","name":"Holder Forensics","description":"Goes past 'top-10 = X%' to classify the holder base: how much the creator & owner still hold, which top holders are infrastructure (LP/CEX/bridge — benign) vs unlabelled wallets (the concentration that can actually dump the price), and the largest non-infra wallet. Separating benign from dangerous concentration is the analysis others skip.","url":"https://402.com.tr/api/x402/holder-forensics","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"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"Token contract address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_K8vFpOIOdiRI7xdSQw9jQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Classifies a token's holder base into creator/owner holdings, benign infrastructure wallets (LP/CEX/bridge), and unlabelled wallets that pose real dump risk, plus identifies the largest non-infrastructure wallet.","exampleAgentPrompt":"Can you run a holder forensics analysis on the token at contract address 0x1234...abcd and tell me how much the creator still holds, which of the top wallets are just LPs or exchanges, and which ones are unlabelled wallets that could actually dump the price?","exampleUseCases":[{"title":"Pre-investment rug pull check","prompt":"Before I ape into this token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48, can you do a holder forensics breakdown — I want to know if the dev still holds a big chunk, and how much of the top-holder concentration is actually risky unlabelled wallets versus just LPs and CEXs?"},{"title":"Token launch due diligence for a launchpad","prompt":"We're listing a new token and I need a full holder forensics report on contract 0xdAC17F958D2ee523a2206206994597C13D831ec7 — specifically the creator and owner wallet percentages, which top holders are infrastructure, and who the biggest non-infrastructure wallet is."},{"title":"Comparing dump risk across two tokens","prompt":"I'm trying to decide between two tokens and I want to know which one has more dangerous holder concentration — can you pull holder forensics on 0x6B175474E89094C44Da98b954EedeAC495271d0F and tell me what percentage of supply is in unlabelled wallets that could dump?"}],"resultDescription":"Returns a breakdown of the token's holder base including: how much the creator and owner wallets still hold, which top holders are classified as infrastructure (liquidity pools, CEX wallets, bridges — benign), which are unlabelled/unclassified wallets representing real dump risk, and the identity and size of the largest non-infrastructure wallet.","failureModes":["Invalid or non-existent contract address returns an error","Contract address for a non-token contract may return unexpected results","Very new tokens with few transactions may have incomplete holder data","Rate limiting or payment failure returns 402 Payment Required","Token on an unsupported chain returns no data"],"whenToPreferThis":"Use this endpoint when you need to go beyond simple top-holder percentage statistics and actually understand the nature of concentration risk — specifically when you need to distinguish benign infrastructure wallets (LPs, CEXs, bridges) from unlabelled wallets that represent real sell pressure. Prefer this over generic holder analytics when assessing rug pull risk, due diligence before investment, or evaluating token health on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:48:05.733Z","isFirstParty":false}