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"]} trades)')

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

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.

Authentication

Pass your API key in the X-API-Key header on every request. You can also use the ?api_key= query parameter, though the header is preferred for security.

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 →