---
title: "Whales Recent"
method: GET
path: "/v1/whales/recent"
tags: ["whales-public"]
---

# Whales Recent

`GET /v1/whales/recent`

## Request

- Base URL: `https://api.bitpoort.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.bitpoort.com/v1/whales/recent`
- Auth: none required

Public endpoint: recent whale transactions. No auth required.

Supports optional ``since``/``until`` ISO 8601 time-window filtering
and ``cursor`` for keyset pagination. When a window or cursor is
provided the discovery cache is bypassed (each page is unique).
Response includes ``next_cursor`` for the next page (null when the
last page is reached) and ``has_more``.

## Query parameters

- `chain` string: Chain: ETH, BTC, ALL
- `limit` integer
- `min_usd` number: Minimum USD value
- `since` string, nullable: ISO 8601 datetime, e.g. 2026-05-01T00:00:00Z
- `until` string, nullable: ISO 8601 datetime, e.g. 2026-05-02T00:00:00Z
- `cursor` string, nullable: Opaque cursor from a previous response's next_cursor field

## Response `200`

Recent whale-tier transfers for the requested chain. Each whale carries from/to addresses + entity labels, USD value, tier, and ISO timestamp. Supports since/until and opaque cursor pagination via next_cursor / has_more.

- WhalesRecentResponse
  - `count` integer, required
  - `chain` string, required
  - `min_usd` number, required
  - `since` string, nullable
  - `until` string, nullable
  - `next_cursor` string, nullable
  - `has_more` boolean, required
  - `whales` WhaleItem[], required
    - `tx_hash` string, required
    - `block_number` integer, required
    - `chain` string, required
    - `from_address` string, required
    - `to_address` string, required
    - `from_entity` string, nullable
    - `to_entity` string, nullable
    - `value_usd` number, required
    - `token_symbol` string, required
    - `tier` string, required
    - `timestamp` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/bitpoort/apis/bitpoort-api.md) · [All operations](https://skmtc.dev/bitpoort/apis/bitpoort-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bitpoort/apis/bitpoort-api/revisions/1a51d8566777?raw)