Whale movements summary — aggregated stats rollup (no auth, MCP-compatible)

Returns an aggregated statistics rollup of whale on-chain movements over a period, so AI agents don't have to page through raw /api/public/whale-movements rows to compute totals themselves. Breaks down movement counts and REAL USD totals (from the same usd_value column as /api/public/whale-movements) by chain and by flow direction (inflow/outflow/transfer). USD totals only ever include rows with a resolvable price — unresolvedUsdCount reports how many movements in the window had no resolvable USD value, so totals are never silently inflated or fabricated. period filter: 7d | 30d | 90d (default 7d — a shorter default than the raw archive's 90d, since a rollup is most useful over a recent window). Response: { sinceDays, movementCount, movementsWithResolvedUsd, unresolvedUsdCount, totalUsd, byDirection, usdByDirection, topChainsByUsd[], firstSeenAt, lastSeenAt, dataSource, updatedAt }. No authentication required. 60 requests/min rate limit. Cached ~5min.

get/api/public/whale-movements/summary

Request

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

Query parameters

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

Time window: 7d | 30d | 90d (default 7d).

Response

Aggregated whale-movement summary for the requested period.

sinceDaysnumber

Number of days covered by this summary.

movementCountnumber

Total whale movements recorded in the window.

movementsWithResolvedUsdnumber

Subset of movementCount that had a resolvable USD value.

unresolvedUsdCountnumber

Movements with no resolvable USD value — excluded from every USD sum below.

totalUsdnumber

Sum of usd_value across all resolved movements in the window (whole dollars).

firstSeenAtstring date-time nullable
lastSeenAtstring date-time nullable
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.