Public whale movements archive — paginated 1-year history (no auth, MCP-compatible)

Returns a paginated archive of large whale on-chain movements recorded in the CryptoWhaleInsights signal-history database, covering up to 1 year (365 days). This is the public, unauthenticated counterpart to the authenticated /api/whale-history endpoint: it omits the explorerUrl field (Pro-only). AI agents can use this to analyse historical on-chain flow direction (inflow/outflow/transfer) across 14 chains without any credentials. Supported chains (chain filter values): BTC, ETH, SOL, BSC, BASE, ARB, POLYGON, TON, SUI, HYPE, TRX, SEI, INJ, APT. Supported directions (direction filter values): inflow, outflow, transfer. Keyword search: use ?q= to filter by token name, signal summary, or wallet label (case-insensitive, max 100 chars). Example: ?q=USDT returns only moves mentioning USDT; ?q=ETH+Whale+%237 returns moves by that wallet label. USD filter: use ?minUsd= to only return movements at or above that real USD value, e.g. ?minUsd=1000000 for $1M+ moves. Movements with no resolvable USD value (usdValue: null) are excluded when minUsd is set. Pagination: page (1-indexed, default 1), pageSize fixed at 20. period filter: 7d | 30d | 90d | 365d (default 90d). Use 365d to retrieve up to 1 year of history. Response: { items[], total, page, pageSize, hasMore, sinceDays, dataSource, updatedAt }. Each item: id, tokens (chain in [0]), typeLabel, outcome, returnPct, direction ('inflow'|'outflow'|'transfer'|null), walletLabel, createdAt. No authentication required. 60 requests/min rate limit.

get/api/public/whale-movements

Request

  • Base URL: https://cryptowhaleinsights.com
  • URL: https://cryptowhaleinsights.com/api/public/whale-movements
  • Auth: none declared

Query parameters

pageinteger

Page number (1-indexed, default 1).

chain'BTC' | 'ETH' | 'SOL' | 'BSC' | 'BASE' | 'ARB' | 'POLYGON' | 'TON' | 'SUI' | 'HYPE' | 'TRX' | 'SEI' | 'INJ' | 'APT'

Filter by chain. Valid values: BTC, ETH, SOL, BSC, BASE, ARB, POLYGON, TON, SUI, HYPE, TRX, SEI, INJ, APT. Default: all chains.

direction'inflow' | 'outflow' | 'transfer'

Filter by flow direction: inflow | outflow | transfer. Default: all directions.

period'7d' | '30d' | '90d' | '365d'

Time window: 7d | 30d | 90d | 365d (default 90d). Use 365d to retrieve up to 1 year of history.

qstring

Keyword search (case-insensitive, max 100 chars). Matches against token name, signal summary, or wallet label. Example: q=USDT returns moves mentioning USDT; q=ETH+Whale+%237 returns moves by that wallet label.

Response

Paginated public whale movements (up to 1 year / 365-day window, no auth).

totalnumber

Total matching records in the window

pagenumber

Current page (1-indexed)

pageSizenumber

Fixed at 20 records per page

hasMoreboolean

Whether more pages are available

sinceDaysnumber

Number of days of history returned

dataSourcestring
updatedAtstring date-time

Example response

{
  "attribution": {
    "source": "CryptoWhaleInsights",
    "url": "https://cryptowhaleinsights.com",
    "usagePolicy": "https://cryptowhaleinsights.com/api-usage"
  }
}

Changes

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