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

# Recent whale transactions (paginated)

`GET /whales/recent`

## Request

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

## Query parameters

- `limit` integer
- `min_btc` number
- `flow` 'to_exchange' | 'from_exchange' | 'wallet_to_wallet' | 'exchange_to_exchange' | 'self_send'
- `before` string
- `since_id` integer
- `lang` 'en' | 'de' | 'es'

## Response `200`

Array of whale objects with intent classification

- WhaleListResponse
  - `count` integer
  - `data` WhaleTx[]
    - `block_height` integer
    - `btc_amount` number
    - `fee_sat_per_vb` number
    - `flow_type` 'to_exchange' | 'from_exchange' | 'wallet_to_wallet' | 'exchange_to_exchange' | 'self_send'
    - `recipient_label` string, nullable
    - `sender_label` string, nullable
    - `ts` string, date-time
    - `txid` string
    - `usd_at_tx` number
    - `volume_index_calibrated` 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)