Skip to content

Whale Alert System

Real-time notification system for large order placement and smart money movements. Framework: Python + requests.

Live Output Preview

If you ran this bot right now, the API would return:

# Live API output — March 12, 2026
Market Regime: Mean-Reverting
Safety Score: 96.2 (HIGH)

Composite Signals:
  BTC: buy (score: 0.172)\n  ETH: buy (score: 0.228)\n  SOL: buy (score: 0.219)\n  HYPE: strong_buy (score: 0.371)\n
# The bot would use this data to make trading decisions

Complete Source Code

Copy this code, replace YOUR_API_KEY with your key, and run:

import requests, time, json

API_KEY = "YOUR_API_KEY"
BASE = "https://algotick.dev"

def monitor_whales():
    """Alert on significant whale activity across all coins."""
    for coin in ["BTC", "ETH", "SOL", "HYPE"]:
        resp = requests.get(f"{{BASE}}/v1/signals/whale-flow",
                           params={{"coin": coin, "api_key": API_KEY}})
        data = resp.json()

        imbalance = data.get("whale_imbalance", 0)
        orders = data.get("whale_orders", [])
        bid_total = data.get("total_whale_bid_usd", 0)
        ask_total = data.get("total_whale_ask_usd", 0)

        if abs(imbalance) > 0.3:
            direction = "BUYING" if imbalance > 0 else "SELLING"
            print(f"\n[WHALE ALERT] {{coin}} — {{direction}}")
            print(f"  Imbalance: {{imbalance:.3f}}")
            print(f"  Bid pressure: ${{bid_total:,.0f}}")
            print(f"  Ask pressure: ${{ask_total:,.0f}}")

            for order in orders[:5]:
                side = order.get("side", "?")
                size = order.get("size_usd", 0)
                price = order.get("price", 0)
                print(f"  {{side.upper()}} ${{size:,.0f}} @ ${{price:,.2f}}")

while True:
    monitor_whales()
    time.sleep(30)

Setup Instructions

  1. Get an API key from the API page
  2. Replace YOUR_API_KEY in the code above
  3. Install dependencies: pip install requests (Python) or npm install node-fetch (TypeScript)
  4. Run the script and monitor the output
  5. Connect your exchange API for live trading

API Endpoints Used

Framework
Python + requests
Data Source
Algo Tick API
# All endpoints used by this template:
curl -H "X-API-Key: YOUR_KEY" https://algotick.dev/v3/signals/regime
curl -H "X-API-Key: YOUR_KEY" https://algotick.dev/v1/signals/composite
curl -H "X-API-Key: YOUR_KEY" https://algotick.dev/v3/signals/safety
curl -H "X-API-Key: YOUR_KEY" https://algotick.dev/v1/signals/volatility?coin=BTC

Don't just stare at the dashboard. Automate it.

Every metric on this page is available via our sub-millisecond API.
Build trading bots, backtest strategies, and power AI agents with institutional-grade data.

Get API Key →

More Python Templates

Other Frameworks