{"uid":"cap_tOHrcmvEXlSwOyjpnSknm","slug":"aayat-ai-token-holder-distribution-62d8fdb9","name":"Aayat AI Token Holder Distribution","description":"Token holder concentration now and over time: holder count, top-1 and top-10 share, the top 10 that can actually sell (excluding pools and locks), supply held by exchanges, funds and contracts, labelled top holders, plus stored history with 1/7/30-day changes and a trend (concentrating or distributing). ?address=...&chain=base&days=30","url":"https://aayatai.com/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":["address"],"properties":{"days":{"type":"integer","default":30,"maximum":365,"minimum":1,"description":"History to return (days)."},"chain":{"enum":["base","solana","ethereum","bsc","arbitrum","polygon","optimism","avalanche"],"type":"string","default":"base","description":"Blockchain: base, solana, ethereum, bsc, arbitrum, polygon, optimism, avalanche."},"address":{"type":"string","maxLength":64,"description":"Token contract address (0x...) or Solana mint address."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["address","chain","now","history","trend"],"properties":{"now":{"type":"object","description":"Current concentration: count, top1, top10, sellable top10, share by holder kind, labelled top holders."},"chain":{"type":"string"},"trend":{"type":["object","null"],"description":"Change since the first snapshot and over 1/7/30 days; direction concentrating, distributing or stable."},"trust":{"type":"object","description":"Third-party text, cleaned: read trust.notice; removed = what we stripped."},"address":{"type":"string"},"history":{"type":"array","description":"Stored snapshots, one per day (oldest first): holders, top1, top10, sellable top10, exchange share."},"sources":{"type":"array","items":{"type":"string"}},"checkedAt":{"type":"string"},"historyNote":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"now":{"top":[{"kind":"contract","label":"GnosisSafeProxy","address":"0x06A19654e0872Ba71c2261EA691Ecf8a0c677156","percent":22.571}],"count":1225686,"byKind":{"fund":0,"pool":1.66,"locked":3.49,"wallet":45.17,"contract":38.81,"exchange":8.55},"source":"Blockscout","top1Percent":22.57,"top10Percent":61.89,"top10SellablePercent":58.4},"chain":"base","trend":{"d1":null,"d7":null,"d30":null,"since":"2026-09-27T12:00:00.000Z","direction":"stable","holdersChange":786,"top10PointsChange":0.19},"address":"0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed","history":[{"at":"2026-09-27T12:00:00.000Z","top1":22.6,"top10":61.7,"holders":1224900,"exchange":8.5,"top10Sellable":58.2}],"sources":["Blockscout","stored snapshots"],"checkedAt":"2026-09-28T12:00:00.000Z","historyNote":""}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_w-i82R3YeVGlQfHdfZ6tG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current and historical holder concentration data for a crypto token, including top holder percentages, holder counts by type, and trend direction across multiple blockchains.","exampleAgentPrompt":"Can you check the holder distribution for the token at 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed on Base — I want to know what percentage the top 10 wallets own, how many holders there are total, and whether concentration has been increasing or decreasing over the last 30 days?","exampleUseCases":[{"title":"Token safety check before investing","prompt":"Before I buy this token, can you check if it's whale-dominated? The contract is 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed on Base — tell me what the top 10 holders control and whether ownership is concentrating or spreading out."},{"title":"DeFi protocol governance decentralization audit","prompt":"I need to audit how decentralized our DAO token is on Ethereum — look up the holder distribution for 0xC18360217D8F7Ab5e7c516566761Ea12Ce7F9D72 and tell me the breakdown by wallet type and what the top holder controls."},{"title":"Monitoring token distribution trend over time","prompt":"Keep an eye on the holder concentration trend for this Solana token mint address DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB1, pull the last 7 days of history and tell me if whales are accumulating or distributing."}],"resultDescription":"Returns a JSON object containing: current snapshot with total holder count, top-1 and top-10 holder percentages, sellable top-10 percentage, breakdown by holder kind (wallet, contract, exchange, pool, locked, fund), and labeled top holders with addresses and percentages. Also includes a trend object showing changes over 1, 7, and 30-day windows with a direction label (concentrating, distributing, or stable). Historical daily snapshots are provided oldest-first. A trust field may contain third-party safety notes. Metadata includes the data source (e.g. Blockscout), checked timestamp, and chain.","failureModes":["Invalid or non-existent token contract address returns an error or empty result","Unsupported chain value returns a validation error","Address not found on the specified chain returns null or empty holder data","History parameter out of range (< 1 or > 365) triggers schema validation failure","Rate limiting or payment failure (x402) if USDC balance is insufficient","No historical snapshots available for new tokens results in empty history array and null trend fields"],"whenToPreferThis":"Choose this endpoint when you need on-chain holder distribution analytics for a specific token — particularly for token safety research, rug-pull risk assessment, or decentralization audits. It is superior to generic token info APIs when you need holder breakdown by wallet type (exchange, contract, locked, pool), trend direction over time, and labeled top holder identities. Supports 8 major chains. Best used alongside token price or safety endpoints for comprehensive due diligence.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T18:44:04.818Z","isFirstParty":false,"canonicalSlug":"aayat-ai-token-holder-distribution-62d8fdb9"}