{"uid":"cap_UhSbeTLl__0Jldl1Reue_","slug":"meryol-agenticmarket-x402-hf-space-20e5d7e7","name":"ERC-20 Top Holder Concentration Report","description":"Pre-trade exit-liquidity check for an ERC-20: top-10 holder concentration %, ex-LP/ex-known-router concentration, per-holder balance %, contract-or-EOA flag. High concentration = thin exit liquidity. Chains: ethereum, base, arbitrum, optimism.","url":"https://meryol-agenticmarket-x402.hf.space/holders/top/:chain/:token?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","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","required":["chain","token"],"properties":{"chain":{"enum":["ethereum","base","arbitrum","optimism"],"type":"string"},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["holders","top_n_concentration_pct"]}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","pathParams":{"chain":"ethereum","token":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},"queryParams":{}}},"response":{"name":"USDC","chain":"ethereum","notes":[],"token":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","top_n":10,"symbol":"USDC","holders":[{"address":"0x37305b1cd40574e4c5ce33f8e8306be057fd7341","balance_pct":7.9301,"is_contract":false,"discount_label":null},{"address":"0x38aaef3782910bdd9ea3566c839788af6ff9b200","balance_pct":4.0834,"is_contract":true,"discount_label":"ERC1967Proxy"},{"address":"0xe1940f578743367f38d3f25c2d2d32d6636929b6","balance_pct":3.2865,"is_contract":true,"discount_label":"ERC1967Proxy"},{"address":"0xffa69c0080582098af595156240214b742735a5e","balance_pct":3.0603,"is_contract":true,"discount_label":"ERC1967Proxy"},{"address":"0xad354cfbaa4a8572dd6df021514a3931a8329ef5","balance_pct":2.7065,"is_contract":true,"discount_label":"ERC1967Proxy"},{"address":"0x40ec5b33f54e0e8a33a975908c5ba1c14e5bbbdf","balance_pct":2.302,"is_contract":true,"discount_label":"RootChainManagerProxy"},{"address":"0xee7ae85f2fe2239e27d9c1e23fffe168d63b4055","balance_pct":1.6031,"is_contract":true,"discount_label":"ERC1967Proxy"},{"address":"0x01b8697695eab322a339c4bf75740db75dc9375e","balance_pct":1.4872,"is_contract":false,"discount_label":null},{"address":"0x3d09d2354530466d32ed37c6ad19ea58504a0c37","balance_pct":1.154,"is_contract":false,"discount_label":null},{"address":"0x08f619716db7c6245401b543e59acac1d25cb483","balance_pct":1.1451,"is_contract":true,"discount_label":"ERC1967Proxy"}],"decimals":6,"total_supply":"51726571168460782","holders_count_total":7844020,"top_n_concentration_pct":28.7582,"top_n_concentration_ex_known_pct":10.5713}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_lqbxfP97_IRvP06h5M_Te","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns top-N holder analysis for an ERC-20 token including concentration percentages, contract/EOA flags, and well-known wallet labels for rug/sniper risk assessment.","exampleAgentPrompt":"Before I ape into this token, can you pull the top holder concentration report for 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum and tell me if it's dangerously concentrated or if any whales are contracts that could dump?","exampleUseCases":null,"resultDescription":"A structured report containing: the top-N holder list with per-holder balance percentages, total top-10 concentration percentage, concentration excluding known LPs and routers, a contract-or-EOA flag for each address, and well-known labels (e.g. Uniswap LP, known sniper) where available.","failureModes":["Invalid or non-checksummed token address returns 400","Unsupported chain returns 400 with enum error","Token with no on-chain holder data (e.g. newly deployed) may return empty or partial results","Payment not provided or insufficient returns 402","Rate limiting or upstream RPC failure returns 503","Non-ERC-20 contract address may return unexpected or empty holder data"],"whenToPreferThis":"Use this endpoint when an agent needs to perform a pre-trade rug check or whale concentration assessment on an ERC-20 token on Ethereum, Base, Arbitrum, or Optimism. Prefer this over generic block explorers when you need structured, machine-readable concentration metrics with LP/router exclusion and contract labeling in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:42:54.992Z","isFirstParty":false,"canonicalSlug":"meryol-agenticmarket-x402-hf-space-20e5d7e7"}