Whale transactions API GET /api/v1/transactions

Home › API docs › Recent whale moves · 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/transactions?limit=50"

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}/transactions", headers=HEADERS,
                 params={"limit": 50}, timeout=10)
r.raise_for_status()
page = r.json()["data"]
for tx in page["transactions"]:
    kind = "DEX swap" if tx["action"].startswith("SWAP_") else "exchange transfer"
    print(tx["timestamp"], tx["token"], tx["action"], kind,
          f'${tx["usd_value"]:,.0f}', tx["exchange"] or "-")

# older page:
# requests.get(f"{BASE}/transactions", headers=HEADERS,
#              params={"limit": 50, "before_id": page["next_before_id"]})

Sample response EXAMPLE VALUES

{
  "data": {
    "transactions": [
      {
        "id": 10000002,
        "tx_hash": "0x8b85…2b93",
        "wallet": "0x83d8…e09e",
        "token": "LINK",
        "direction": "BUY",
        "action": "CEX_WITHDRAW",
        "usd_value": 412500.0,
        "timestamp": "2026-01-01T12:00:00+00:00",
        "exchange": "Binance"
      },
      {
        "id": 10000001,
        "tx_hash": "0x41c0…9a07",
        "wallet": "0x5b2e…77d1",
        "token": "PEPE",
        "direction": "SELL",
        "action": "SWAP_SELL",
        "usd_value": 150000.0,
        "timestamp": "2026-01-01T11:58:40+00:00",
        "exchange": ""
      }
    ],
    "next_before_id": 10000001
  },
  "meta": {
    "tier": "whale",
    "endpoint": "/api/v1/transactions",
    "generated_at": "2026-01-01T12:00:05+00:00"
  }
}

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

Fields

Notes and limits

• Scope: moves by tracked whale wallets only. An exchange transfer counts when the wallet on our side is a tracked whale; exchanges’ own internal transfers are excluded, and rows priced above $1B are dropped.
• There is no size filter parameter: filter on usd_value in your code (the webhooks have a min_usd filter).
• Moves can arrive late (for example DEX history filled in after the fact), so de-duplicate on id rather than assuming a gap-free stream.
• Free alternative without a key: the MCP server tool get_recent_whale_moves returns the latest 15 moves at or above a size you choose.

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

Is there an API to track large Ethereum wallet transfers?

Yes. GET https://deepbluealpha.io/api/v1/transactions returns the latest moves by 20,000+ tracked Ethereum whale wallets with tx hash, wallet, token, USD value, timestamp and a label: exchange withdrawal, exchange deposit or DEX swap. It needs an API key (Whale plan, 25,000 calls/day per key, or Business, 250,000/day).

Is a CEX_WITHDRAW row a purchase?

No. CEX_WITHDRAW is a transfer off an exchange and CEX_DEPOSIT a transfer onto one. Only SWAP_BUY and SWAP_SELL rows are DEX trades.

How to page through older whale moves?

Pass next_before_id from one response as before_id in the next request. Rows are ordered newest first by id.

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