Daily whale data files CSV + JSONL
Daily files of every move by tracked Ethereum whale wallets (CSV + JSONL), per-coin totals, manifest with SHA-256, graded signals. History from Jul 1, 2026 (DEX) and Sep 6, 2026 (exchange).
Home › API docs › Daily data files · Updated 2026-10-26
Business accounts get one set of files per UTC day with every move by tracked Ethereum whale wallets, ready shortly after 00:40 UTC, downloadable from the account page or with an API key. History goes back to July 1, 2026 for DEX swaps and September 6, 2026 for exchange moves. A free 7-day sample CSV with the same columns needs no account.
Endpoints
Base URL https://deepbluealpha.io · JSON over HTTPS · Ethereum mainnet only.
X-API-Key header (or a signed-in session). The sample CSV is public.Parameters
| Name | Type | Default | Description |
|---|---|---|---|
name | path, string | — | A file name from the /data/files list. |
Example request (curl)
curl -s -H "X-API-Key: $DBA_API_KEY" https://deepbluealpha.io/data/files
curl -s -H "X-API-Key: $DBA_API_KEY" -O \
https://deepbluealpha.io/data/files/dba_whale_moves_2026-10-15.csv.gz
# free sample, no key
curl -s -O https://deepbluealpha.io/data/sample.csvPython example
import os, requests, pandas as pd
H = {"X-API-Key": os.environ["DBA_API_KEY"]}
name = "dba_whale_moves_2026-10-15.csv.gz"
with open(name, "wb") as f:
f.write(requests.get(f"https://deepbluealpha.io/data/files/{name}", headers=H, timeout=60).content)
df = pd.read_csv(name)
print(df.groupby(["token", "action"])["usd_value"].sum().sort_values().tail(10))
dba_whale_moves_YYYY-MM-DD.csv.gz (example rows) EXAMPLE VALUES
time_utc,tx_hash,wallet,token,action,usd_value,venue_type,event_id,exchange
2026-01-01T12:00:00Z,0x8b85…2b93,0x83d8…e09e,LINK,CEX_WITHDRAW,412500.00,exchange,mv_10000002,Binance
2026-01-01T11:58:40Z,0x41c0…9a07,0x5b2e…77d1,PEPE,SWAP_SELL,150000.00,dex,mv_10000001,Field names and structure are the real ones; the numbers, hashes and addresses are placeholders, not live data.
Fields
| Field | Meaning |
|---|---|
dba_whale_moves_YYYY-MM-DD.csv.gz | Every move: time_utc, tx_hash, wallet, token, action, usd_value, venue_type, event_id, exchange. |
dba_whale_moves_YYYY-MM-DD.jsonl.gz | The same rows as JSON Lines. |
dba_token_totals_YYYY-MM-DD.csv.gz | Per coin: moves, wallets, exchange withdrawn / deposited / net, DEX swap buy / sell / net. |
dba_manifest_YYYY-MM-DD.json | Row counts, a SHA-256 per file and the day’s coverage. |
dba_graded_signals.csv.gz | Every graded whale signal, rewritten daily (see signals). |
Notes and limits
- The two most recent days are rebuilt once more so late-arriving moves land in their day.
- Days before 2026-09-06 are marked
coverage: dex_only; DEX coverage was thinner in July and August. - Scope: tracked whale wallets as of the day the file was built. Labels are heuristic — see the methodology.
- Sharing raw move-level rows or files outside your organization needs Enterprise (from $999/mo, by email quote: team@deepbluealpha.io).
Errors
401— Missing, invalid or revoked API key.403— No Business plan on the key.404— File not found.
FAQ
Where can you download Ethereum whale transaction data as CSV?
A free 7-day sample is at https://deepbluealpha.io/data/sample.csv (top 10 coins, up to 5,000 rows). Full daily CSV and JSONL files of every tracked whale move come with the Business plan, with history from Jul 1, 2026 (DEX swaps) and Sep 6, 2026 (exchange moves).
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
