Back to Browse
Aayat AI Token Holder Distribution
x402
Aayat AI Token Holder Distribution is a paid API for AI agents from aayatai.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-02).
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.
Price / call$0.01
Success—
StatusUnknown
How this service works
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
Output
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.
Example use cases
Token safety check before investing
“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.”
DeFi protocol governance decentralization audit
“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.”
Monitoring token distribution trend over time
“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.”
Technical details
Endpoint
GEThttps://aayatai.com/token/holders?utm_source=zero.xyzWhen to prefer
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.
Side effects
- 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
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
Schema · Response
{
"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": ""
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"