{"uid":"cap_Aev2zsSWIZaO-yJ8mDuvj","slug":"preflight-top-token-holders-3487f55a","name":"PreFlight Top Token Holders","description":"Pre-trade & pre-sign checks for autonomous agents: everything an agent verifies BEFORE signing a transaction — token due diligence, calldata red-flag decoding, oracle freshness, holder concentration, bridge routing with executable calldata, cross-venue perp funding, gas and price sanity checks. EVM chains: Ethereum, Base, Arbitrum, Optimism.","url":"https://meryol-agenticmarket-x402.hf.space/holders/top/%7Bchain%7D/%7Btoken%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"chain":"base","notes":[],"token":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","top_n":10,"symbol":"USDC","holders":[{"address":"0xabc...","balance_pct":8.1,"is_contract":true,"discount_label":"uniswap_v4_router"}],"top_n_concentration_pct":41.2,"top_n_concentration_ex_known_pct":18.4}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PWU6WHkBEyd8k6V2O6Ad4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","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 token holders for a given token on an EVM chain, including balance percentages, contract labels, and concentration metrics.","exampleAgentPrompt":"Before I buy this token, can you pull the top 10 holders of 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 on Base and tell me what percentage of supply they control — and flag any that are known contracts like routers or exchanges?","exampleUseCases":null,"resultDescription":"A JSON object listing the top N holders of the specified token on the given chain, each with their address, balance percentage, whether they are a contract, and a label (e.g. 'uniswap_v4_router') if recognized. Also returns aggregate concentration percentages — total top-N concentration and concentration excluding known protocol addresses — plus the token symbol and any warning notes.","failureModes":["Unsupported chain returns an error or empty response","Invalid token contract address returns no holders","Token with no on-chain holder data returns empty holders array","Rate limiting or payment failure (x402) blocks the call","Hugging Face Space cold start causes timeout"],"whenToPreferThis":"Use this endpoint when you need to assess token holder concentration risk before executing a trade or signing a transaction on an EVM chain (Ethereum, Base, Arbitrum, Optimism). It is purpose-built for autonomous agent pre-trade checks and distinguishes known protocol contracts from real whale wallets, making it more useful than a raw blockchain query for risk assessment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:30:33.432Z","isFirstParty":false}