Whale wallet leaderboard & watchlist API /top-wallets

Home › API docs › Whale wallets & watchlist · Updated 2026-10-26

Endpoints

Base URL https://deepbluealpha.io · JSON over HTTPS · Ethereum mainnet only.

Parameters

Example request (curl)

curl -s -H "X-API-Key: $DBA_API_KEY" \
  "https://deepbluealpha.io/api/v1/top-wallets?limit=100"

curl -s -H "X-API-Key: $DBA_API_KEY" \
  https://deepbluealpha.io/api/v1/watchlist

Python example

import os, requests

BASE = "https://deepbluealpha.io/api/v1"
HEADERS = {"X-API-Key": os.environ["DBA_API_KEY"]}   # dba_...

wl = requests.get(f"{BASE}/watchlist", headers=HEADERS, timeout=10).json()["data"]
for w in wl["wallets"]:
    print(w["address"], w["label"], f'7d net ${w["net_flow_usd_7d"]:,.0f}', w["trades_7d"], "moves")

Sample response EXAMPLE VALUES

// GET /api/v1/top-wallets
{
  "data": {
    "wallets": [
      { "address": "0x83d8…e09e", "label": "Whale", "rank": 1, "volume_usd": 25000000.0 }
    ]
  },
  "meta": { "tier": "whale", "endpoint": "/api/v1/top-wallets",
            "generated_at": "2026-01-01T12:00:00+00:00" }
}

// GET /api/v1/watchlist
{
  "data": {
    "wallets": [
      { "address": "0x83d8…e09e", "label": "My whale", "net_flow_usd_7d": 120000.0, "trades_7d": 6 }
    ],
    "tokens": [
      { "symbol": "LINK", "label": null, "net_flow_usd_7d": 300000.0, "trades_7d": 25 }
    ]
  },
  "meta": { "tier": "whale", "endpoint": "/api/v1/watchlist",
            "generated_at": "2026-01-01T12:00:00+00:00" }
}

Field names and structure are the real ones; the numbers, hashes and addresses are placeholders, not live data.

Fields

Notes and limits

• Wallets are chosen by holdings (about $250K or more in ETH and volatile tokens), with exchange, bridge and router addresses and market-maker patterns removed. See the methodology.
• Add wallets and tokens to the watchlist on the website; the endpoint is read-only.

Errors

• 401 — Missing, invalid or revoked API key.
• 403 — The key belongs to a plan below Whale (and has no Business plan).
• 429 — Daily limit reached. Resets at 00:00 UTC. Back off; do not retry in a tight loop.

FAQ

Can you follow specific Ethereum whale wallets by API?

Yes. Save the wallets on your Deep Blue Alpha watchlist, then GET /api/v1/watchlist returns each with 7-day net flow and move count. For every individual move, filter /api/v1/transactions on the wallet field, or use Business webhooks.

More endpoint docs

Guides: best Ethereum whale tracking APIs compared · real-time whale tracking for a trading bot · whale webhook APIs · methodology · OpenAPI 3.0 spec · Business plan