{"uid":"cap_LHf36VOg2xRXPctVMeA7H","slug":"x402node-token-holder-statistics-0d081de2","name":"x402node Token Holder Statistics","description":"Token holder statistics with growth trend - total holders, how they acquired the token (swap/transfer/airdrop) and holder count change across time windows flagged as accumulating or distributing - an adoption and accumulation signal for agents that LLMs cannot see, from data behind an API key. holder stats, holder count, holder growth, token adoption, accumulation signal, holders increasing, holder change","url":"https://api.x402node.dev/chain/holder-stats?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":["token"],"properties":{"chain":{"type":"string","description":"base (default), eth, arbitrum, optimism, polygon"},"token":{"type":"string","description":"Token contract (required)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","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.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Jv-1b01qPI5HYKpeJVJ0J","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns total holder count, acquisition breakdown (swap/transfer/airdrop), and holder count change across time windows as an accumulation or distribution signal for an ERC20 token.","exampleAgentPrompt":"Pull the holder stats for token contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Base — I want to see total holders, how they acquired it, and whether the holder count is accumulating or distributing right now.","exampleUseCases":null,"resultDescription":"Returns total holder count for the specified ERC20 token, a breakdown of how holders acquired the token (via swap, transfer, or airdrop), and holder count changes across multiple time windows each flagged as either accumulating or distributing — serving as a quantitative token adoption and accumulation signal.","failureModes":["Invalid or unrecognized contract address returns error or empty result","Unsupported chain returns error","Insufficient payment or missing x402 auth header returns 402 Payment Required","Token with no on-chain Transfer event history may return zero or incomplete stats","Rate limiting if called too frequently without valid payment","Network timeout on slow RPC data aggregation"],"whenToPreferThis":"Use this endpoint when you need on-chain holder growth signals and acquisition-method breakdowns for an ERC20 token — particularly for gauging token adoption momentum, detecting accumulation vs distribution phases, or understanding organic vs airdrop-driven holder bases. Prefer this over price-only feeds when holder behavior is the key signal.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:23.373Z","isFirstParty":false,"canonicalSlug":"x402node-token-holder-statistics-0d081de2"}