# Crypto Whale Alert Feed – Large On-Chain Transfers

> Crypto Whale Alert Feed – Large On-Chain Transfers is a paid API for AI agents from x402-agent-store.rileycraig14.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns the largest recent USDC/WETH/cbBTC/USDT/WBTC transfers on Base or Ethereum with USD value, wallet labels, and tx metadata for whale-watching and smart-money flow monitoring.

## Facts

- Endpoint: GET https://x402-agent-store.rileycraig14.workers.dev/crypto/whales
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-whale-alert-feed-large-on-chain-transfers-83e5e405
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hRZUVwe9ktSMU6iC2K_bT

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 crypto-whale-alert-feed-large-on-chain-transfers-83e5e405
```

Example prompt: Show me the top 25 largest USDC transfers on Ethereum right now, only ones above $50,000 — I want to see the wallet labels and whether any of them are flagged as scams.

## When to prefer this

Use this endpoint when you need a real-time feed of large on-chain token transfers (whale alerts) for Base or Ethereum without a Nansen subscription. It is ideal for trading agents that need to front-run or react to big smart-money flows, or for analysts monitoring token distribution. Prefer this over generic blockchain explorers when you also need counterparty labels (scam flags, contract vs EOA, verified entity) alongside transfer size and recency.

## Known failure modes

- Invalid chain value (not 'base' or 'ethereum') returns 400 or empty result
- Token symbol not supported on the selected chain returns empty whale list
- limit out of range (>50 or <1) may be clamped or return error
- min_usd too high may result in zero matching transfers
- Payment not included or invalid x402 payment header returns 402 Payment Required
- Network/RPC timeout returns 5xx error

## How this service works

Live whale alerts: the largest recent USDC / WETH / cbBTC / USDT / WBTC transfers on Base or Ethereum, with USD value, from/to wallets, counterparty labels (contract? verified? scam-flagged?), tx hash and age. The smart-money / whale-watching feed trading agents poll to front-run big flows — a Nansen-style whale alert without the subscription. Each whale wallet chains into /crypto/smart-money (what is this wallet doing?) and /crypto/wallet (what does it hold?).

## Output

A list of whale transfer events including USD value, from/to wallet addresses with counterparty labels (is it a contract? verified? scam-flagged?), transaction hash, token transferred, chain, and how long ago the transfer occurred. Typically returns up to 50 results depending on the limit parameter.

## 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",
     "properties": {
      "chain": {
       "type": "string",
       "description": "base|ethereum (default base)"
      },
      "limit": {
       "type": "number",
       "description": "1-50, default 15"
      },
      "token": {
       "type": "string",
       "description": "usdc|weth|cbbtc (base) or usdc|usdt|weth|wbtc (ethereum), or any ERC-20 contract 0x... (default usdc)"
      },
      "min_usd": {
       "type": "number",
       "description": "Minimum transfer size in USD (default 10000)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "number"
      },
      "whales": {
       "type": "array"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-whale-alert-feed-large-on-chain-transfers-83e5e405/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-agent-store.rileycraig14.workers.dev](https://www.zero.xyz/host/x402-agent-store.rileycraig14.workers.dev/llms.txt)