Top whale tokens API /top-tokens

Home › API docs › Top whale tokens · Updated 2026-10-26

Endpoints

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

Parameters

Example request (curl)

# free, no key
curl -s https://deepbluealpha.io/api/v1/public/top-tokens

# with a key: 7-day window, 50 tokens
curl -s -H "X-API-Key: $DBA_API_KEY" \
  "https://deepbluealpha.io/api/v1/top-tokens?tf=7D&limit=50"

Python example

import requests

r = requests.get("https://deepbluealpha.io/api/v1/public/top-tokens", timeout=10)
r.raise_for_status()
for t in r.json()["tokens"]:
    print(t["symbol"], f'net ${t["net_flow_usd"]:,.0f}', t["whales"], "whale wallets")

Sample response EXAMPLE VALUES

// GET /api/v1/public/top-tokens (free)
{
  "as_of": "2026-01-01T12:00:00Z",
  "window": "24h",
  "source": "https://deepbluealpha.io/tokens",
  "tokens": [
    {
      "symbol": "LINK",
      "volume_usd": 2000000.0,
      "trades": 20,
      "buy_volume_usd": 1500000.0,
      "sell_volume_usd": 500000.0,
      "net_flow_usd": 1000000.0,
      "whales": 10,
      "detail_url": "https://deepbluealpha.io/token/LINK"
    }
  ]
}

// GET /api/v1/top-tokens?tf=24H (API key)
{
  "data": {
    "timeframe": "24H",
    "tokens": [
      { "symbol": "LINK", "net_flow_usd": 1000000.0,
        "buy_volume_usd": 1500000.0, "sell_volume_usd": 500000.0, "trades": 20 }
    ]
  },
  "meta": { "tier": "whale", "endpoint": "/api/v1/top-tokens",
            "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. Run the curl above for the live response.

Fields

Notes and limits

• To split a token’s flow into exchange transfers and DEX swaps, call /api/v1/token/{symbol}/flow.
• Both endpoints count tracked whale wallets only and drop rows priced above $1B.

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.
• 503 — Public endpoint: data temporarily unavailable.

FAQ

Is there a free API for the tokens Ethereum whales are moving?

Yes. GET https://deepbluealpha.io/api/v1/public/top-tokens needs no key and returns the top 10 tokens by tracked whale volume over 24 hours, with net flow and whale-wallet counts. License: CC BY 4.0 with attribution to Deep Blue Alpha.

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