API DOCS

Free whale data endpoints no API key

Free Ethereum whale data with no API key: /api/v1/public/stats, /top-tokens and /whale-index. JSON, CORS enabled, cached 60s, CC BY 4.0. Fields and examples.

Home › API docs › Free stats endpoint · Updated 2026-10-26

Three endpoints are free and need no key: /api/v1/public/stats (coverage and 24-hour flow totals, split into exchange withdrawals, exchange deposits and DEX swaps), /api/v1/public/top-tokens and /api/v1/public/whale-index. They return JSON with CORS enabled, are cached for 60 seconds and are licensed CC BY 4.0 with the attribution “Deep Blue Alpha (deepbluealpha.io)”.

Endpoints

GET/api/v1/public/stats
GET/api/v1/public/top-tokens
GET/api/v1/public/whale-index

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

Authentication
None. CORS: Access-Control-Allow-Origin: *.
Rate limit
No formal limit. Responses are cached 60 seconds server-side; abuse may trigger IP throttling.
Plan & license
Free. CC BY 4.0 — credit “Deep Blue Alpha (deepbluealpha.io)”.

Example request (curl)

curl -s https://deepbluealpha.io/api/v1/public/stats
curl -s https://deepbluealpha.io/api/v1/public/top-tokens
curl -s https://deepbluealpha.io/api/v1/public/whale-index

Python example

import requests

s = requests.get("https://deepbluealpha.io/api/v1/public/stats", timeout=10).json()
d, w = s["data"], s["data"]["window_24h"]
print("tracked wallets:", d["tracked_wallets"], "| newest move:", d["latest_transaction_utc"])
print(f'24h withdrawn from exchanges ${w["exchange_withdrawal_volume_usd"]:,.0f}, '
      f'deposited ${w["exchange_deposit_volume_usd"]:,.0f}, DEX swaps ${w["dex_swap_volume_usd"]:,.0f}')

Sample response EXAMPLE VALUES

{
  "product": "Deep Blue Alpha",
  "homepage": "https://deepbluealpha.io",
  "docs": "https://deepbluealpha.io/api-docs",
  "version": 1,
  "as_of_utc": "2026-01-01T12:00:00+00:00",
  "data": {
    "tracked_wallets": 20000,
    "tracked_tokens": 1000,
    "transactions_total": 2000000,
    "latest_transaction_utc": "2026-01-01T11:59:00+00:00",
    "window_24h": {
      "buy_volume_usd": 150000000,
      "sell_volume_usd": 50000000,
      "distinct_buyers": 150,
      "dex_swap_volume_usd": 1000000,
      "exchange_withdrawal_volume_usd": 149000000,
      "exchange_deposit_volume_usd": 49000000
    }
  },
  "notes": "Observational on-chain data. Not financial advice. ...",
  "license": "CC-BY-4.0 (attribution: Deep Blue Alpha, deepbluealpha.io)",
  "rate_limit": "No formal rate limit. Responses are cached for 60s server-side. ..."
}

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

FieldMeaning
tracked_wallets / tracked_tokensSize of the tracked whale set and the number of tokens seen.
latest_transaction_utcTime of the newest recorded move — a freshness check.
window_24h.buy_volume_usd / sell_volume_usdDirection of flow over 24 hours. Most of it is exchange transfers, not swaps; the three split fields below break it out.
dex_swap_volume_usdDEX swap volume (the trades).
exchange_withdrawal_volume_usd / exchange_deposit_volume_usdTokens moved off / onto exchanges.
distinct_buyersDistinct wallets on the accumulation side in 24 hours (field name kept for compatibility).

Notes and limits

Errors

FAQ

Where can you get Ethereum whale data for free?

Deep Blue Alpha publishes three no-key JSON endpoints (/api/v1/public/stats, /top-tokens, /whale-index), a free MCP server at https://deepbluealpha.io/mcp and a free 7-day sample CSV of labeled whale moves at https://deepbluealpha.io/data/sample.csv. All are CC BY 4.0 with attribution.

Do the free endpoints need an API key?

No. They are open, CORS-enabled and cached 60 seconds. Authenticated endpoints under /api/v1 need a key from the Whale or Business plan.

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

Not financial advice. Deep Blue Alpha data describes what tracked wallets did on-chain. It does not predict prices and is not a trading recommendation. Labels are heuristics from known address lists; see the methodology. Facts on this page checked 2026-10-26.