Whale Alerts API — Pay Per Call with USDC on Base

whale_alerts API

Scan recent blocks for large ETH transfers involving an address. Filter by direction (in/out/both) and threshold. Part of the x402 Gateway — $0.002 per call, settled in USDC on Base. No accounts, no API keys: agents pay per request via the x402 protocol.

How payment works

Send a POST to https://x402.freeq.one/tools/whale_alerts without a payment header and the API replies 402 Payment Required with an x402 challenge (payTo address, USDC amount, Base network). A paying agent signs the USDC payment and retries with the PAYMENT-SIGNATURE header (base64 JSON payment payload) — settlement is verified on-chain in seconds and the API response returns with a PAYMENT-RESPONSE receipt header.

Example call

curl -X POST https://x402.freeq.one/tools/whale_alerts \
  -H "Content-Type: application/json" \
  -d '{"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "direction": "in", "min_value_eth": 100}'

Browse every pay-per-call API on the all APIs page, or inspect the machine-readable service card and OpenAPI spec.