{"uid":"cap_ZKQxTpu5piVGiqCwWYA_f","slug":"tracefast-token-holders-506c0e5f","name":"TraceFast Token Holders","description":"TraceFast live Ethereum data: the largest current holders of a token contract. Up to 100 holders in descending balance order, balance in the token's smallest unit, plus holderCount — how many addresses hold a positive balance now. Path token: contract address, 0x-prefixed, 40 hex. Query limit: integer 1..100, default 100. Docs: https://docs.tracefast.xyz/api/token-holders.md","url":"https://mpp.tracefast.xyz/api/v1/chains/1/tokens/:token/holders","method":"GET","headers":{},"bodySchema":{"properties":{"input":{"required":["method"],"properties":{"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2u0dtqmDzkt-mX51zDOIl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top holders of an Ethereum ERC-20 token contract by balance in descending order, including holder count, using live on-chain data.","exampleAgentPrompt":"Give me the top 25 holders of the USDC token contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum, with their balances and total holder count.","exampleUseCases":[{"title":"Whale concentration check for DeFi token","prompt":"Who are the top 50 holders of the token at 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum? I want to see their balances and how many addresses total hold the token."},{"title":"Token distribution audit before listing","prompt":"Pull the top 100 holders of this token contract 0x6B175474E89094C44Da98b954EedeAC495271d0F and tell me how many unique addresses hold a positive balance right now."},{"title":"Monitoring whale wallets for a stablecoin","prompt":"Get me the 10 largest holders of the USDT contract 0xdAC17F958D2ee523a2206206994597C13D831ec7 on Ethereum along with their current balances."}],"resultDescription":"An ordered list of up to 100 holder objects, each containing the wallet address and token balance in the token's smallest unit (e.g. wei-equivalent), plus a holderCount field indicating the total number of addresses currently holding a positive balance of the token.","failureModes":["Invalid or malformed contract address (not 0x-prefixed or not 40 hex chars) returns an error","Contract address exists but is not a token contract may return empty or error","Limit parameter outside 1–100 range may return validation error","Token with no holders or very new contract may return empty list","Network or payment failure (x402 micropayment not completed) blocks the response","Rate limiting or quota exceeded may return 429"],"whenToPreferThis":"Use this endpoint when you need live, ranked token holder data for any ERC-20 on Ethereum mainnet — especially for whale analysis, concentration checks, or governance research. Prefer this over block explorer scraping when you need programmatic access, structured JSON output, and a precise holderCount. Best for agents that need top-N holder snapshots without running their own indexer.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:42.172Z","isFirstParty":false}