# Solana x402 Whale Alerts API

> Solana x402 Whale Alerts API is a paid API for AI agents from solana-x402-xi.vercel.app, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns large on-chain token transfer alerts (whale movements) for a specified blockchain, filterable by token and minimum USD value.

## Facts

- Endpoint: POST https://solana-x402-xi.vercel.app/api/v1/whale-alerts
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/solana-x402-whale-alerts-api-cb6d72ef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DA1NhXc3Y6o6n6b6U_1Yo

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 solana-x402-whale-alerts-api-cb6d72ef -d '<json body>'
```

Example prompt: Show me the top 20 whale alerts on Ethereum for USDC transfers above $500,000 right now.

## When to prefer this

Choose this endpoint when you need real-time or near-real-time detection of large on-chain token movements on EVM-compatible chains like Ethereum, Base, Polygon, or Arbitrum. It is ideal for trading signal pipelines, DeFi risk monitoring, or alert systems that need to react to whale behavior. Prefer it over generic block explorers when you need pre-filtered, USD-denominated transfer data via a simple API call.

## Known failure modes

- Missing required 'chain' query parameter returns a validation error
- Unsupported chain name returns an empty result or error
- Payment not fulfilled via x402 returns HTTP 402 Payment Required
- Limit out of range (above 50 or below 1) returns a validation error
- Network or RPC issues may return 500 or timeout errors

## How this service works

Blockchain data APIs with x402 payments on Solana + Base via PayAI facilitator. 7 endpoints covering bridge routing, whale alerts, DeFi yields, RPC, NFT, token, and transaction history.

## Output

A list of whale transfer alerts for the specified chain, each containing transaction details such as token symbol, transfer amount in USD, sender and receiver wallet addresses, and transaction hash. Results are filtered by the optional minimum USD amount and token symbol, capped at the specified limit.

## 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": [
      "POST"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "chain"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Blockchain to monitor (e.g. ethereum, base, polygon, arbitrum)"
      },
      "limit": {
       "type": "number",
       "description": "Number of alerts to return (1-50)"
      },
      "token": {
       "type": "string",
       "description": "Filter by token symbol (optional)"
      },
      "minAmountUSD": {
       "type": "number",
       "description": "Minimum USD value of transfers to track"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/solana-x402-whale-alerts-api-cb6d72ef/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from solana-x402-xi.vercel.app](https://www.zero.xyz/host/solana-x402-xi.vercel.app/llms.txt)