WhaleScope API
## WhaleScope API WhaleScope API monitors Ethereum for large on-chain transfers in real-time and makes that data available through a simple REST API. Every transaction above your threshold — whale wallets moving USDT, USDC, WETH, WBTC, and other major tokens — is captured, labeled where possible, and made instantly queryable. Unlike block explorer APIs that require you to poll individual…
WhaleScope API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Health | ||
| GET |
/health /health |
|
| Alerts | ||
| GET |
/whale/alerts /whale/alerts |
Returns recent large on-chain transfers (default $100K+ USD). Free plan: min $1M, max 20 results. Paid plans: min $500K, max 100 results. |
| Labels | ||
| GET |
/whale/label/{address} /whale/label/{address} |
Returns known entity label for an Ethereum address (exchange, fund, protocol, etc.). Useful for identifying whether a whale is a CEX hot wallet, DeFi protocol, or unknown. |
| Watchlist | ||
| GET |
/whale/watches /whale/watches |
Returns all active watchlists for your API key. Requires Starter plan. |
| DELETE |
/whale/watch/{id} /whale/watch/{id} |
|
| POST |
/whale/watch /whale/watch |
Monitor a specific address, token, or the entire chain for whale moves. Fires a webhook when a transfer exceeds your threshold. Requires Starter plan or above. |
WhaleScope API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 10 / minute |
|
| PRO | $9 / month | 60 / minute |
|
| ULTRA | $29 / month | 200 / minute |
|
| MEGA Recommended | $99 / month | 500 / minute |
|