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.

Authentication

Every request needs your API key in the X-API-Key header (or ?api_key= query param). 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 (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).

GET/api/v1/token/{symbol}/flow

One token's whale flow over 24h / 7d / 30d (net flow, buy/sell volume, trades, distinct wallets).

GET/api/v1/watchlist

Your saved watchlist (wallets + tokens) with 7-day net flow and trade counts per item.

Example response

{
  "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" }
}

Errors

401 — missing / invalid / revoked key
403 — key belongs to a tier below Whale
429 — daily rate limit reached (resets at UTC midnight)

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 →

Not financial advice. All data is provided for informational purposes only and does not constitute a recommendation to buy, sell, or hold any asset. Past on-chain activity is not indicative of future results. Cryptocurrency trading involves substantial risk of loss. Full Disclaimer