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

limitinteger

min_btcnumber

flow'to_exchange' | 'from_exchange' | 'wallet_to_wallet' | 'exchange_to_exchange' | 'self_send'

Filter by flow classification. self_send = internal change-output sweeps (Hot-Cold consolidations, not real cross-address flows).

beforestring

Opaque cursor from previous page's next_cursor field (historical pagination).

since_idinteger

Legacy frontier streaming cursor — only works for rows since 2026-04 with populated id column.

lang'en' | 'de' | 'es'

Response

Array of whale objects with intent classification

countinteger

next_cursorstring nullable

Example response

{
  "count": 50,
  "data": [
    {
      "block_height": 902456,
      "btc_amount": 1247.83,
      "fee_sat_per_vb": 12.4,
      "flow_type": "to_exchange",
      "recipient_label": "Binance Hot Wallet",
      "sender_label": "Coinbase Custody",
      "ts": "2026-04-30T08:14:22+00:00",
      "txid": "f4184fc596403b9d638783cf57adfe4c75c605f6356fbc91338530e9831e9e16",
      "usd_at_tx": 87412345.5,
      "volume_index_calibrated": 0.78
    }
  ],
  "next_cursor": "eyJ0cyI6IjIwMjYtMDQtMzBUMDg6MTQ6MjJaIn0="
}

Changes

No recorded changes to this operation across all 1 revision of this API.