---
title: "Large on-chain transfers"
method: GET
path: "/crypto/whales"
tags: ["crypto"]
---

# Large on-chain transfers

`GET /crypto/whales`

## Request

- Base URL: `https://kresmion.com/v1`
- URL: `https://kresmion.com/v1/crypto/whales`
- Auth: HTTP bearer

Recent large exchange-wallet / whale transfers (≥ $100k). Filter by blockchain (ETH|BTC|SOL), flow direction, and a look-back window (≤ 720h). 

CAVEAT: do NOT read BTC exchange netflow from this feed: BTC rows are dominated by exchange-internal (self) transfers, so BTC inflow/outflow is an artifact. Genuine tradeable flow is in ETH + stablecoin rows.

ATTRIBUTION: `is_internal_transfer` marks a same-owner move established on attributed-or-better wallet evidence; it is excluded from every aggregate we publish. `internal_transfer_unverified` marks a row whose two sides resolve to the same entity on HEURISTIC evidence only: it is COUNTED as flow and flagged, because sweep-behaviour inference cannot distinguish an exchange-owned deposit address from a third party who only ever sends to that exchange. `label_confidence` gives the weakest tier used (curated | confirmed | attributed | heuristic).

## Query parameters

- `min_usd` number: USD size floor (hard minimum $100k).
- `blockchain` string, nullable: ETH | BTC | SOL
- `direction` string, nullable: exchange_inflow | exchange_outflow | exchange_transfer
- `hours` integer: Look-back window in hours.
- `limit` integer

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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