WHALE

Deep Blue Alpha API

Pull DBA's whale intelligence as JSON — into your spreadsheets, bots, dashboards, and models. Read-only, key-authenticated, available on the Whale tier.

What you get

Six read-only JSON endpoints over the same tracked-whale data the website runs on:

Rate limit
25,000 calls / day
Counted per API key (each of your up to 5 keys has its own daily count), resets at UTC midnight. Past the cap, requests return 429 until the reset.
How to get a key
$79.99 / month · $709 / year
API access is part of the Whale plan. Once subscribed, create a key on your account page.
See the Whale plan →

Your first request

Copy, paste, swap in your key:

curl -s -H "X-API-Key: dba_your_key_here" \
  https://deepbluealpha.io/api/v1/token/LINK/flow

Response shape EXAMPLE VALUES

{
  "data": {
    "symbol": "LINK",
    "windows": {
      "24h": {
        "net_flow_usd": 250000.00,
        "buy_volume_usd": 1000000.00,
        "sell_volume_usd": 750000.00,
        "trades": 40,
        "wallets": 12,
        "dex_buy_usd": 50000.00,
        "dex_sell_usd": 25000.00,
        "exchange_withdraw_usd": 950000.00,
        "exchange_deposit_usd": 725000.00
      },
      "7d":  { ...same fields... },
      "30d": { ...same fields... }
    }
  },
  "meta": {
    "tier": "whale",
    "endpoint": "/api/v1/token-flow",
    "generated_at": "2026-01-01T00:00:00+00:00"
  }
}

The numbers above are placeholders to show the shape, not live data. buy_volume_usd is the accumulation side (DEX buys plus coins pulled off exchanges) and sell_volume_usd the distribution side (DEX sells plus coins sent to exchanges); the four split fields show how much of each was a real swap versus an exchange transfer.

Using Claude, ChatGPT or Cursor? Connect them to our free MCP server at deepbluealpha.io/mcp — no key needed.

Try every endpoint in Postman: open the Deep Blue Alpha collection → · Machine-readable spec: OpenAPI 3.0 (JSON)

Authentication

Every request needs your API key in the X-API-Key header. (The older ?api_key= query parameter still works but is deprecated: keys in URLs end up in browser history and proxy logs, so please switch to the header.) Generate a key from your account page (Whale tier). Keys are shown once at creation — store them securely.

curl -H "X-API-Key: dba_your_key_here" \
  https://deepbluealpha.io/api/v1/whale-index

Base URL: https://deepbluealpha.io/api/v1 · Rate limit: 25,000 requests/day per API key (Whale) · All responses are JSON in the shape { "data": …, "meta": { "tier", "endpoint", "generated_at" } }.

Endpoints

GET/api/v1/whale-index
Daily 0–100 whale sentiment score with its trade- and volume-sentiment components.
GET/api/v1/top-tokens?tf=24H&limit=25
Per-token net whale flow (net_flow_usd, buy/sell volume, trades). tf = 1H | 24H | 7D. Stablecoins excluded.
GET/api/v1/top-wallets?limit=25
Whale leaderboard — address, tracked volume, rank, label.
GET/api/v1/transactions?limit=50&before_id=
Recent whale transactions, newest first. Paginate with before_id (use next_before_id from the response). Each row has an exchange field naming the exchange on exchange moves (empty on DEX swaps).
GET/api/v1/token/{symbol}/flow
One token's whale flow over 24h / 7d / 30d (net flow, buy/sell volume, trades, distinct wallets). Buy/sell combine DEX swaps with exchange withdrawals/deposits; each window also splits them out as dex_buy_usd, dex_sell_usd, exchange_withdraw_usd, exchange_deposit_usd. ETH includes native ETH, recorded as WETH.
GET/api/v1/watchlist
Your saved watchlist (wallets + tokens) with 7-day net flow and trade counts per item.

Endpoint reference pages

One page per endpoint group, each with parameters, auth, limits, curl and Python examples and a sample response:

Example response: /top-tokens EXAMPLE VALUES

{
  "data": {
    "timeframe": "24H",
    "tokens": [
      { "symbol": "LINK", "net_flow_usd": 1174687.65,
        "buy_volume_usd": 4820102.1, "sell_volume_usd": 3645414.45, "trades": 128 }
    ]
  },
  "meta": { "tier": "whale", "endpoint": "/api/v1/top-tokens",
            "generated_at": "2026-08-18T20:00:00+00:00" }
}

Business plan: higher limits, webhooks and daily files

How every field is built (exchange vs DEX labels, whale scope, pricing, history): see the data methodology.

Business: $299/month or $2,990/year (subscribe). This section documents what a Business plan includes, so you can plan an integration now. Business is for commercial use inside your organization (see the Business & API Terms); the Whale plan’s API is for personal use. Questions: team@deepbluealpha.io.

Webhook events

Add endpoints in your account. Each event is a POST with Content-Type: application/json, sent within seconds of the move being recorded:

{
  "type": "whale_move",
  "event_id": "mv_8812345",
  "api_version": "2026-10-16",
  "time_utc": "2026-10-16T10:41:23Z",
  "tx_hash": "0x8b85…2b93",
  "wallet": "0x83d8…e09e",
  "token": "LINK",
  "action": "CEX_WITHDRAW",
  "usd_value": 412500.00,
  "venue_type": "exchange",
  "exchange": "Binance",
  "flow": "withdrawn_from_exchange"
}

Verify the signature

Every request carries X-DBA-Signature: t=<unix seconds>,v1=<hex>, where v1 is HMAC-SHA256 of "<t>." + raw request body keyed with your webhook’s signing secret (whsec_…, shown once when you create the webhook or rotate the secret). Also sent: X-DBA-Event-Id, X-DBA-Timestamp. Check the signature on the raw bytes, before parsing, and reject timestamps older than 5 minutes.

import hmac, hashlib, time

def verify(secret: str, body: bytes, header: str, tolerance: int = 300) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(","))
    ts, sig = int(parts["t"]), parts["v1"]
    if abs(time.time() - ts) > tolerance:
        return False
    want = hmac.new(secret.encode(), f"{ts}.".encode() + body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(want, sig)

Delivery, retries and pausing

Daily data files

Moves by tracked whale wallets, one set per UTC day, ready shortly after 00:40 UTC. The two most recent days are rebuilt once more so late-arriving moves land in their day. Download from your account, or with your API key (each call counts toward your daily limit):

curl -H "X-API-Key: dba_YOUR_KEY" https://deepbluealpha.io/data/files
curl -H "X-API-Key: dba_YOUR_KEY" -O https://deepbluealpha.io/data/files/dba_whale_moves_2026-10-15.csv.gz

Graded whale signals

Every whale signal Deep Blue Alpha has fired since April 2026, each with the coin’s % price change 1, 7 and 30 days after the signal and ETH’s change over the same window. Graded on closing prices, never peaks: entry = median price within 2 hours of the signal; outcome = median price around +1d / +7d / +30d. Blank = not matured yet or no price data. Business plan only. Past results do not predict future results. Not investment advice.

GET/api/v1/signals?start=2026-09-01&end=2026-09-30&graded_only=true&limit=500
Signal rows, oldest first. Filters: start, end (YYYY-MM-DD; default the last 30 days; max 400-day window), signal_type (comma-separated), token, graded_only (only rows with a 7-day result). limit up to 1,000 per page; page with after_id = next_after_id from the response (null on the last page). Fields: signal_id, fired_at_utc, signal_type, token, token_address, entry_price_usd, ret_1d_pct, ret_7d_pct, ret_30d_pct, eth_1d_pct, eth_7d_pct, eth_30d_pct, vs_eth_7d_pct, verdict_7d, complete.
GET/api/v1/signals/summary?start=2026-07-01&end=2026-09-30
Per signal type and overall: n, hit rate (share with a 7-day result above +1%), verdict counts, average and median 7-day result, and the share that beat ETH over the same 7 days. Same start / end / signal_type / token filters.

verdict_7d: BIG_WIN above +10%, WIN above +1%, FLAT above −1%, else LOSS. The same rows ship as dba_graded_signals.csv.gz in /data/files, refreshed daily.

Backtests by API

POST /api/backtest/run accepts a Business API key in the X-API-Key header (each run counts toward your daily limit). In the browser, the backtest page still needs Alpha or higher. Body:

curl -X POST -H "X-API-Key: dba_YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"start":"2026-08-01","end":"2026-09-30","signal_types":[]}' \
  https://deepbluealpha.io/api/backtest/run

Errors

Changelog

Not financial advice

API data is on-chain analytics for informational purposes only — not financial advice. Past whale activity is not predictive of future results.

Ready to build?
API access is included with the Whale tier. Generate a key → or upgrade to Whale →