---
title: "Recent Ethereum whale transactions (paginated)"
method: GET
path: "/eth/whales/recent"
tags: ["ETH"]
---

# Recent Ethereum whale transactions (paginated)

`GET /eth/whales/recent`

## Request

- Base URL: `https://swisswhaleintelligence.com/v1`
- URL: `https://swisswhaleintelligence.com/v1/eth/whales/recent`
- Auth: HTTP bearer

Whale-tier ETH transactions with cluster-attribution from Layer-1 labels (Etherscan) + Layer-3 graph-detection hybrid (ADR-001).

## Query parameters

- `limit` integer
- `min_eth` number
- `hours` integer
- `flow` 'to_exchange' | 'from_exchange' | 'wallet_to_wallet' | 'exchange_to_exchange' | 'self_send'
- `before` string

## Response `200`

Array of ETH whale txs with cluster + label attribution

- EthListResponse
  - `count` integer
  - `data` EthWhaleTx[]
    - `block_number` integer
    - `eth_amount` number
    - `flow_type` 'to_exchange' | 'from_exchange' | 'wallet_to_wallet' | 'exchange_to_exchange' | 'self_send'
    - `from_address` string
    - `from_cluster_id` string, nullable
    - `from_label` string, nullable
    - `to_address` string
    - `to_cluster_id` string, nullable
    - `to_label` string, nullable
    - `ts` string, date-time
    - `tx_hash` string
    - `usd_at_tx` number
  - `next_cursor` string, nullable

## Other responses

- `401`: Authentication required or failed. Includes X-RateLimit-* headers when key was identified.
- `429`: Rate limit exceeded. Honour Retry-After header.

---

[API](https://skmtc.dev/swisswhaleintelligence/apis/swiss-whale-intelligence-api.md) · [All operations](https://skmtc.dev/swisswhaleintelligence/apis/swiss-whale-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/swisswhaleintelligence/apis/swiss-whale-intelligence-api/revisions/dcb44bc52418?raw)