# x402-gateway Whale Alerts

> x402-gateway Whale Alerts is a paid API for AI agents from x402.freeq.one, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Fetches large on-chain cryptocurrency transfer alerts (whale movements) across blockchain networks, paid per-call via x402 on Base.

## Facts

- Endpoint: POST https://x402.freeq.one/tools/whale_alerts
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-gateway-whale-alerts-94036441
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mImA2HQFjBrTXs8D44pVy

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 x402-gateway-whale-alerts-94036441 -d '<json body>'
```

Example prompt: Show me the latest whale alerts — large on-chain transfers over $1 million in ETH on Ethereum from the past hour.

## When to prefer this

Choose this endpoint when you need real-time or near-real-time large on-chain transfer alerts and want to pay per-call with no subscription, using USDC on Base via x402. Prefer over scraping block explorers or subscribing to expensive whale-tracking SaaS when usage is intermittent.

## Known failure modes

- Payment not received or x402 payment header missing — returns 402 Payment Required
- No whale alerts found for specified parameters — returns empty result set
- Invalid token symbol or unsupported chain — returns error or empty response
- Network timeout if upstream blockchain data provider is slow
- Rate limiting if too many calls in a short window

## How this service works

Pay-per-call MCP gateway: 12 tools (markdown, token_price, wallet_portfolio, whale_alerts, cross_chain_balance, changelog_openapi, changelog_git, mermaid, html_to_markdown, qr_generator, og_image_generator, jobs). Per-tool prices on Base via the Coinbase CDP x402 facilitator: markdown=$0.001, token_price=$0.0005, wallet_portfolio=$0.002, whale_alerts=$0.002, cross_chain_balance=$0.002, changelog_openapi=$0.005, changelog_git=$0.005, mermaid=$0.005, html_to_markdown=$0.001, qr_generator=$0.001, og_image_generator=$0.001, jobs=$0.002. MCP flat rate $0.001.

## Output

Returns a list of large on-chain transfer events including transaction hashes, sender and receiver wallet addresses, token type, amount transferred, USD value, blockchain network, and timestamp. Useful for identifying market-moving wallet activity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "description": "Ethereum address to monitor"
  },
  "direction": {
   "type": "string",
   "description": "in, out, or both (default both)"
  },
  "min_value_eth": {
   "type": "number",
   "description": "Minimum ETH value threshold"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-gateway-whale-alerts-94036441/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.freeq.one](https://www.zero.xyz/host/x402.freeq.one/llms.txt)