Ethereum Whale Flow API

What the API delivers

Deep Blue Alpha’s API exposes the same whale intelligence that powers the dashboard — as structured JSON, ready for your code. Six read-only endpoints, one API key, no SDK required.

All responses use a consistent JSON envelope: { "data": ..., "meta": { "tier", "endpoint", "generated_at" } }. Full technical reference: API documentation →

Why developers choose this API

What developers build with it

Get started in 30 seconds

curl

curl -H "X-API-Key: dba_your_key_here" \
  "https://deepbluealpha.io/api/v1/top-tokens?tf=24H&limit=10"

Python

import requests

API_KEY = "dba_your_key_here"
BASE    = "https://deepbluealpha.io/api/v1"

# Top tokens by net whale flow (last 24 hours)
resp = requests.get(
    f"{BASE}/top-tokens",
    headers={"X-API-Key": API_KEY},
    params={"tf": "24H", "limit": 10},
)
data = resp.json()

for token in data["data"]["tokens"]:
    net  = token["net_flow_usd"]
    sign = "+" if net >= 0 else ""
    print(f'{token["symbol"]:6s}  {sign}${abs(net):,.0f}  ({token["trades"]} moves)')

JavaScript (Node.js / fetch)

const API_KEY = "dba_your_key_here";
const BASE    = "https://deepbluealpha.io/api/v1";

const resp = await fetch(`${BASE}/transactions?limit=20`, {
  headers: { "X-API-Key": API_KEY },
});
const { data, meta } = await resp.json();

data.transactions.forEach(tx =>
  console.log(`${tx.symbol} ${tx.direction} $${tx.usd_value.toLocaleString()}`)
);

Example response (/api/v1/top-tokens)

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

How DBA compares to other whale data APIs

Competitor figures as of Oct 16, 2026, from developer.whale-alert.io, nansen.ai/api and the Nansen credits guide. Vendors change prices; check the source before buying. Full comparison of seven providers: Ethereum whale data APIs compared.

Pricing

API access is bundled with the Whale tier — there is no API-only plan. The Whale tier includes every feature on the platform in addition to the API. Generate your API key from your account page after subscribing.

Using the data in a business

The Whale plan’s API is for personal use. For companies, funds and bot businesses, the Business plan ($299/mo or $2,990/yr) adds commercial use inside your organization (card or crypto), 250,000 API calls/day across up to 5 API keys, real-time signed webhooks for every tracked whale move, daily data files (CSV + JSONL; exchange moves from Sep 6, 2026, DEX swaps from Jul 1, 2026), the exchange named on every exchange move, every graded whale signal since April 2026 (with the coin’s 1-, 7- and 30-day result and ETH’s over the same window, on closing prices) via file and /api/v1/signals, and backtests by API key. Business customers may publish aggregated figures and charts in newsletters, research notes and client reports with the credit “Data: Deep Blue Alpha”; raw move-level data, data files, live feeds and apps or terminals that display the data need Enterprise, from $999/mo by email quote at team@deepbluealpha.io. Past results do not predict future results; not investment advice. Buying is self-serve and by email — no calls or demos. See the free sample CSV and the methodology.

Guides for data buyers: whale data API for trading bots · whale webhook APIs · exchange flow data API · data for AI agents (MCP) · whale flow dataset (CSV).

Authentication

Pass your API key in the X-API-Key header on every request. The older ?api_key= query parameter still works but is deprecated: keys in URLs end up in browser history and proxy logs, so please use the header.

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

Error codes: 401 (missing or invalid key), 403 (tier below Whale), 429 (daily rate limit reached — resets at UTC midnight). Full technical documentation: API reference →