# Aayat AI Token Whale Activity

> Aayat AI Token Whale Activity is a paid API for AI agents from aayatai.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-02).

Returns large-transfer whale activity, exchange flows, DEX flows, and a bullish/bearish/neutral bias signal for a given token contract address

## Facts

- Endpoint: GET https://aayatai.com/token/whales?utm_source=zero.xyz
- Price: $0.02/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-whale-activity-484643d1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_M17OYCJdEpLjjRawD8eo0

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-whale-activity-484643d1
```

Example prompt: Can you check whale activity on the PEPE token (0x6982508145454Ce325dDbE47a25d4ec3d2311933) on Ethereum — I want to know if large wallets are moving it to exchanges and whether the signal is bullish or bearish right now?

## When to prefer this

Use this endpoint when you need a fast, structured on-chain whale intelligence snapshot for a specific EVM token — particularly when you want exchange flow direction (bullish/bearish bias), large-transfer lists, and labelled wallet activity (funds, market makers) in a single call. Prefer it over raw blockchain explorers when you need pre-labelled wallets and a synthesized directional signal without building your own aggregation logic. It is especially useful for trading agents, risk monitors, and DeFi research workflows that need to act on whale signals without an account or API key.

## Known failure modes

- Invalid or non-existent contract address returns an error
- Unsupported chain value returns validation error
- minUsd out of allowed range (1000–100,000,000) returns validation error
- Token with very low on-chain activity may return empty transfers array and neutral bias
- Rate limiting or upstream Blockscout/DexScreener outage may cause 5xx response
- Payment failure via x402 if USDC balance is insufficient

## How this service works

Whale and exchange flows for a token on Base, Ethereum, Arbitrum, Optimism or Polygon, from its latest ~250 transfers: large transfers, deposits/withdrawals per exchange (Binance, Coinbase, OKX...), fund and market-maker flows, DEX buys vs sells, top accumulating and distributing wallets, and plain signals. Pass ?address=...&chain=ethereum&minUsd=10000.

## Output

A JSON object containing: directional bias (bullish/bearish/neutral), signal codes with explanatory messages, large transfers list (up to 25, sorted by size), net exchange flows (deposits vs withdrawals by exchange), DEX buy vs sell flows, fund/market maker flows, top accumulator and distributor wallets with labels, token price, and metadata about the scan window (time range and number of transfers scanned).

## 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": {
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "optimism",
        "polygon"
       ],
       "type": "string",
       "default": "base",
       "description": "Blockchain: base, ethereum, arbitrum, optimism, polygon."
      },
      "minUsd": {
       "type": "number",
       "default": 10000,
       "maximum": 100000000,
       "minimum": 1000,
       "description": "Smallest transfer (USD) counted as a whale move."
      },
      "address": {
       "type": "string",
       "maxLength": 42,
       "description": "Token contract address (0x...)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bias": "bearish",
  "note": "",
  "chain": "ethereum",
  "source": "Blockscout (labels incl. Open Labels Initiative), DexScreener",
  "symbol": "PEPE",
  "window": {
   "to": "2026-09-28T04:00:11Z",
   "from": "2026-09-28T03:40:00Z",
   "minutes": 20.2,
   "transfers": 250
  },
  "address": "0x6982508145454Ce325dDbE47a25d4ec3d2311933",
  "signals": [
   {
    "code": "exchange_inflow",
    "message": "Net $52,592 moved onto exchanges (often ahead of selling).",
    "direction": "bearish"
   }
  ],
  "priceUsd": 0.0000042,
  "checkedAt": "2026-09-28T12:00:00.000Z",
  "byExchange": [
   {
    "netUsd": -52592,
    "exchange": "Binance",
    "depositsUsd": 52592,
    "withdrawalsUsd": 0
   }
  ],
  "dexFlowsUsd": {
   "buys": 500,
   "sells": 39993
  },
  "fundFlowsUsd": {
   "sent": 0,
   "received": 79825
  },
  "largeTransfers": [
   {
    "to": "0x24F6...",
    "tx": "0x1bcb...",
    "from": "0x8CEf...",
    "time": "2026-09-28T03:59:35Z",
    "type": "transfer",
    "amount": 41456469482.32,
    "toLabel": null,
    "valueUsd": 173661,
    "fromLabel": null
   }
  ],
  "topAccumulators": [
   {
    "kind": "fund",
    "label": "Wintermute 4",
    "netUsd": 79825,
    "address": "0xf8191D98ae98d2f7aBDFB63A9b0b812b93C873AA"
   }
  ],
  "topDistributors": [
   {
    "kind": "wallet",
    "label": null,
    "netUsd": -173661,
    "address": "0x8CEfE1bB988f8a574E69156a35e65685cDaa7080"
   }
  ],
  "exchangeFlowsUsd": {
   "net": -52592,
   "deposits": 52592,
   "withdrawals": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aayat-ai-token-whale-activity-484643d1/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)