{"uid":"cap_DrYmVlU8-TW2G5MZCpJ1u","slug":"token-holder-distribution-rug-risk-analysis-c68467df","name":"Token Holder Distribution & Rug Risk Analysis","description":"Holder distribution for a token (GoPlus): top-10 holders with %, top10 concentration, creator %, LP lock %, DISTRIBUTED/MODERATE/HIGH verdict. Rug/whale signal. Params: chain, address.","url":"https://opportunity-api-production.up.railway.app/api/token-holders","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":["chain","address"],"properties":{"chain":{"type":"string","description":"ethereum|base|bsc|arbitrum|polygon|optimism|avalanche"},"address":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9fQ8xtOhvg3nK5qLiS2bu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","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, holder concentration verdict, LP lock %, and rug/whale risk signals for any EVM token using GoPlus data.","exampleAgentPrompt":"Can you check the holder distribution for the token at 0x6982508145454Ce325dDbE47a25d4ec3d2311933 on Ethereum — I want to know if it's whale-dominated, what the top-10 concentration looks like, and whether there are any rug or LP lock risks?","exampleUseCases":null,"resultDescription":"Returns the top-10 token holders with their individual percentage of supply, the aggregate top-10 concentration percentage, the creator's remaining holding %, the LP lock percentage, a distribution verdict (DISTRIBUTED / MODERATE / HIGH concentration), and binary rug and whale risk signals.","failureModes":["Invalid or unrecognized contract address returns an error or empty result","Unsupported chain identifier causes a 400 or validation error","Token not indexed by GoPlus returns no holder data","Rate limiting or upstream GoPlus API unavailability causes 5xx errors","Newly deployed token with no GoPlus data returns null or incomplete fields"],"whenToPreferThis":"Use this endpoint when you need a quick, structured risk assessment of token holder distribution before investing or listing a token — especially when you want GoPlus-sourced data with a pre-computed DISTRIBUTED/MODERATE/HIGH verdict and LP lock signal rather than raw on-chain queries. Best for DeFi due diligence workflows across Ethereum, Base, BSC, Arbitrum, Polygon, Optimism, and Avalanche.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:35:56.773Z","isFirstParty":false}