{"uid":"cap_lDtuW7uA7jXdbvu-mLv4I","slug":"fiatdock-erc-20-token-holder-analytics-7dc7fc9f","name":"FiatDock ERC-20 Token Holder Analytics","description":"Who holds an ERC-20: the top 10 holders with their share of supply and whether each is a contract, locked or a burn address, the LP holders and how much LP is locked, the creator's and owner's share, holder count, and concentration with burned/locked supply excluded. Base, Ethereum and five more chains. Send {} for USDC on Base. Pay-per-call via x402. An empty body is answered for USDC on Base (the x402 settlement asset); send {\"token\":\"0x…\"} for any other token.","url":"https://fiatdock.com/v1/token/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":{"chain":{"enum":["base","ethereum","polygon","arbitrum","optimism","bsc","avalanche"],"type":"string","example":"base","description":"Chain, default base"},"token":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxLength":42,"description":"ERC-20 contract address (0x…). Omit the whole body to get USDC on Base"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0027","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.0027/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0027","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0027","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_niVUf4caXcHRAKbCQYOdF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0027","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns top-10 holders, LP holders, lock/burn status, concentration metrics, holder count, and creator/owner share for any ERC-20 token across 7 chains","exampleAgentPrompt":"Who are the top 10 holders of the token at 0x6982508145454Ce325dDbE47a25d4ec3d2311933 on Ethereum, and are any of them burn or locked addresses? Also tell me how much of the LP is locked.","exampleUseCases":[{"title":"Rug pull risk check before investing","prompt":"Before I buy this new token at 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA on Base, can you show me the top holders and tell me if the deployer or any whales hold most of the supply, and whether the liquidity is locked?"},{"title":"Token concentration report for DeFi research","prompt":"I'm researching token distribution on Arbitrum — pull the top 10 holders for 0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8, their share of supply, and exclude burned and locked supply from the concentration calculation."},{"title":"LP lock verification for a new launch","prompt":"This project just launched on Polygon and claims their LP is fully locked — can you check the token at 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 and tell me how much LP is actually locked versus circulating?"}],"resultDescription":"Returns a structured object containing: top 10 holder wallet addresses with their percentage share of total supply and flags indicating whether each is a smart contract, locked, or burn address; LP holder list with locked LP amounts; creator and owner wallet shares; total unique holder count; and a supply concentration metric calculated excluding burned and locked tokens.","failureModes":["Invalid or non-ERC-20 contract address returns an error or empty holder list","Unsupported chain value returns a validation error","Token with very few holders or brand-new deployment may return incomplete data","Payment failure via x402 results in 402 response before data is returned","Rate limiting or upstream node errors may cause transient failures"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, multi-dimensional snapshot of ERC-20 token holder distribution in a single call — especially when you need LP lock status, burn/contract address classification, and concentration metrics together. It is particularly useful for due diligence on new or unknown tokens across Base, Ethereum, Polygon, Arbitrum, Optimism, BSC, and Avalanche. Prefer it over generic blockchain explorers when you need structured, agent-ready JSON output with concentration analysis already computed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:44:34.962Z","isFirstParty":false,"canonicalSlug":"fiatdock-erc-20-token-holder-analytics-7dc7fc9f"}