# Aayat AI Token Holder Distribution

> 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.

## Facts

- Endpoint: GET https://aayatai.com/token/holders?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aayat-ai-token-holder-distribution-62d8fdb9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tOHrcmvEXlSwOyjpnSknm

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability aayat-ai-token-holder-distribution-62d8fdb9
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## 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.

## Request schema (JSON Schema)

```json
{
 "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"
      },
      "history
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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": ""
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aayat-ai-token-holder-distribution-62d8fdb9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aayatai.com](https://www.zero.xyz/host/aayatai.com/llms.txt)