# DopamineDesk Whale Alerts – Large ERC-20 Transfer Monitor

> DopamineDesk Whale Alerts – Large ERC-20 Transfer Monitor is a paid API for AI agents from ai-data-marketplace-1042299154756.us-central1.run.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Scans recent blocks on Base, Ethereum, or Arbitrum and returns large ERC-20 token transfers (whale movements) above a configurable minimum amount.

## Facts

- Endpoint: GET https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/whale_alerts
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dopaminedesk-whale-alerts-large-erc-20-transfer-monitor-5764b070
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qc3mBNYVsKSzAQjzjiC0X

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 dopaminedesk-whale-alerts-large-erc-20-transfer-monitor-5764b070
```

Example prompt: Scan the last 5 blocks on Base for any USDC transfers above 500,000 tokens and return up to 50 results.

## When to prefer this

Choose this endpoint when you need real-time detection of unusually large on-chain token movements (whale alerts) across Base, Ethereum, or Arbitrum, especially for USDC or any specific ERC-20. It is ideal for DeFi risk monitoring, exchange inflow surveillance, and market-impact analysis. Prefer it over generic block explorers when you need structured, agent-ready JSON output with labeled addresses and USD values without building your own RPC queries.

## Known failure modes

- Public RPC block-window cap exceeded — reduce 'blocks' parameter to stay within provider limits
- Invalid chain identifier — must be 'base', 'ethereum', or 'arbitrum'
- No transfers found above threshold — returns empty alerts array, not an error
- Invalid ERC-20 contract address format causes a 400/422 error
- Rate limit or payment failure via x402 returns HTTP 402 if USDC settlement fails

## How this service works

Read recent large ERC-20 transfers directly from Base, Ethereum, or Arbitrum by scanning Transfer logs over the most recent blocks and filtering by a minimum token amount. Defaults to USDC on Base. Public RPC providers cap the scan window, so this covers the most recent blocks rather than a long history, and it does not label exchange wallets.

## Output

Returns a JSON array of alert objects, each containing the transaction hash, sender address or label, recipient address or label, token amount (whole units), estimated USD value, and Unix timestamp of the transfer. Only transfers meeting or exceeding the configured minimum amount threshold are included.

## 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, or arbitrum. Defaults to base."
      },
      "limit": {
       "type": "integer",
       "description": "Maximum transfers to return, 1 to 100. Defaults to 25."
      },
      "token": {
       "type": "string",
       "description": "ERC-20 contract address to scan. Defaults to USDC on the selected chain."
      },
      "blocks": {
       "type": "integer",
       "description": "How many recent blocks to scan, 1 to 10. Public RPC providers cap this window."
      },
      "min_amount": {
       "type": "integer",
       "description": "Minimum transfer size in whole tokens. Defaults to 100000."
      }
     },
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "success",
      "network",
      "min_usd_value",
      "transactions",
      "marketplace_metadata"
     ],
     "properties": {
      "network": {
       "type": "string"
      },
      "success": {
       "type": "boolean"
      },
      "transactions": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "min_usd_value": {
       "type": "integer"
      },
      "marketplace_metadata": {
       "type": "object",
       "required": [
        "data_mode",
        "billable",
        "availability",
        "source"
       ],
       "properties": {
        "source": {
         "type": "string"
        },
        "billable": {
         "type": "boolean"
        },
        "data_mode": {
         "type": "string"
        },
        "availability": {
         "type": "string"
        }
       },
       "additionalProperties": true
      }
     },
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "network": "Base Mainnet",
  "success": true,
  "transactions": [
   "[nested detail omitted from the challenge header; see the full example in /openapi.json]"
  ],
  "min_usd_value": 50000,
  "marketplace_metadata": {
   "source": "public EVM JSON-RPC ERC-20 Transfer logs",
   "billable": true,
   "data_mode": "live_source",
   "availability": "operational"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dopaminedesk-whale-alerts-large-erc-20-transfer-monitor-5764b070/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ai-data-marketplace-1042299154756.us-central1.run.app](https://www.zero.xyz/host/ai-data-marketplace-1042299154756.us-central1.run.app/llms.txt)