Token whale flow API GET /api/v1/token/{symbol}/flow

Home › API docs › Token whale flow · Updated 2026-10-26

Endpoint

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/token/LINK/flow

Python example

import os, requests

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

r = requests.get(f"{BASE}/token/LINK/flow", headers=HEADERS, timeout=10)
r.raise_for_status()
for window, w in r.json()["data"]["windows"].items():
    exchange_net = w["exchange_withdraw_usd"] - w["exchange_deposit_usd"]
    dex_net = w["dex_buy_usd"] - w["dex_sell_usd"]
    print(f"{window}: net off exchanges ${exchange_net:,.0f} | "
          f"net DEX swaps ${dex_net:,.0f} | {w['wallets']} wallets")

Sample response EXAMPLE VALUES

{
  "data": {
    "symbol": "LINK",
    "windows": {
      "24h": {
        "net_flow_usd": 250000.0,
        "buy_volume_usd": 1000000.0,
        "sell_volume_usd": 750000.0,
        "trades": 40,
        "wallets": 12,
        "dex_buy_usd": 50000.0,
        "dex_sell_usd": 25000.0,
        "exchange_withdraw_usd": 950000.0,
        "exchange_deposit_usd": 725000.0
      },
      "7d":  { "...": "same fields" },
      "30d": { "...": "same fields" }
    }
  },
  "meta": {
    "tier": "whale",
    "endpoint": "/api/v1/token-flow",
    "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

• Most tracked whale flow is exchange transfers, not swaps, so read the four split fields before calling a window “buying”. A withdrawal from an exchange is an accumulation-side transfer, not a purchase.
• Same scope as the website: tracked whale wallets only; exchanges’ internal transfers excluded.
• Free alternative without a key: the MCP server tool get_token_whale_activity, or the token page at /token/<SYMBOL>.

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.
• 400 — Missing token symbol.

FAQ

Is there an API for Ethereum exchange inflows and outflows per token?

Yes. GET /api/v1/token/{symbol}/flow returns exchange_withdraw_usd and exchange_deposit_usd per token for 24h, 7d and 30d, counted over 20,000+ tracked whale wallets, with DEX swaps in separate fields.

What does net_flow_usd mean?

Accumulation-side volume (DEX buys plus exchange withdrawals) minus distribution-side volume (DEX sells plus exchange deposits). It describes past flow; it does not predict price.

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