# CortexCloud Whale Alerts

> CortexCloud Whale Alerts is a paid API for AI agents from api.cortexcloud.org, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-13).

Returns large on-chain token transfers (whale movements) above a specified USD threshold for a given blockchain, optionally filtered by wallet address.

## Facts

- Endpoint: GET https://api.cortexcloud.org/v1/data/whale-alerts?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cortexcloud-whale-alerts-063de984
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dkhTy9Ie5liT00Jwoagjg

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 cortexcloud-whale-alerts-063de984
```

Example prompt: Show me the 50 largest token transfers on Ethereum above $500,000 in the last fetch — I want to see if any whales are moving funds right now.

## When to prefer this

Use this endpoint when you need real-time detection of large on-chain token transfers (whale alerts) for blockchain monitoring, DeFi intelligence, or suspicious activity detection — particularly when you want pay-per-call access with no API key signup and USDC settlement. Prefer this over general blockchain explorers when you specifically need threshold-filtered large transfers rather than arbitrary transaction lookups.

## Known failure modes

- Invalid wallet address format (must match ^0x[0-9a-fA-F]{40}$) returns a validation error
- Limit out of range (must be 1–100) returns a parameter error
- Unsupported chain value may return empty results or an error
- Insufficient USDC balance or failed x402 payment returns a 402 Payment Required response
- No whale transfers found above the min_usd threshold returns an empty list

## How this service works

Pay-per-call on-chain data API for AI agents: token prices, risk scoring, wallet intelligence, whale alerts, balances, tx history, cross-chain comparison — evidence-backed JSON, settled in USDC on Base via x402. No API keys, no signup.

## Output

A JSON object containing a list of recent large on-chain transfers matching the specified chain, minimum USD value, and optional wallet filter. Each record typically includes sender/receiver addresses, transfer amount in USD, token details, and transaction metadata. Up to 100 results can be returned per call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "default": "ethereum"
  },
  "limit": {
   "type": "integer",
   "default": 50,
   "maximum": 100,
   "minimum": 1
  },
  "address": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "Optional wallet to watch."
  },
  "min_usd": {
   "type": "number",
   "default": 100000
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "format": "application/json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cortexcloud-whale-alerts-063de984/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.cortexcloud.org](https://www.zero.xyz/host/api.cortexcloud.org/llms.txt)