Whale trades feed
whale_tradesRead-onlyIdempotent
Live whale trades merged across 15 CEX venues plus on-chain DEX swaps (Ethereum, Base, Arbitrum), newest first. Keyless calls get the free shape (BTC/USD + $1M+ CEX trades live, other pairs delayed 30 min, DEX swaps $250K+) and up to 25 rows; a paid developer plan lifts the shape to every pair with no delay and up to 500 rows here (deeper pages on the REST API). Descriptive market data only.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| coin | No | Filter to one coin, for example BTC. A pair like ETH/USD works too, the quote leg is dropped. One symbol, not a list. Omit for every coin. | |
| pair | No | Alias for coin. | |
| limit | No | Max rows returned. Capped at 25 keyless and 500 on a developer plan; asking for more returns the cap, and the payload says so in `capped`. | |
| source | No | Which markets to read: cex for the 15 streamed exchanges, dex for on-chain swaps on Ethereum, Base and Arbitrum, all for both merged. Defaults to all. | |
| min_usd | No | Smallest trade to return, in US dollars, for example 5000000 for $5M and up. Omit for everything already large enough to count as whale-sized. Keyless calls hold on-chain swaps to $250K and up regardless. A size filter runs after the fetch, so scan_capped in the payload states whether the search reached its own ceiling and older matches may exist. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| coin | No | The coin filter that was applied, or null for every coin. | |
| note | No | One line saying what the numbers cover, or why there are none. Read it before reporting any zero as a market reading. | |
| count | No | How many rows this reply carries. | |
| capped | No | Present only when an argument was cut down to a ceiling. Absent means nothing was clamped, so a smaller number than you asked for is the data and not a limit. | |
| source | No | Which markets were read: cex, dex or all. | |
| trades | No | The matching trades, newest first. A CEX row carries pair, exchange, price, size and side; an on-chain row carries the token, the wallet and the dollar size. Every row carries source. | |
| covered | No | False when the coin asked for is not one this feed streams, so nothing was searched. That is different from a quiet market. | |
| matched | No | How many trades matched the filters before the row cap was applied. | |
| available | No | False when this lane could not answer: a producer is dark, the pair sits outside this plan, or the argument named something we do not carry. Absent or true means the numbers are a real reading, not a guess. | |
| scan_note | No | Says the search stopped at its ceiling, so this is not the complete set for the window. | |
| truncated | No | True when more rows matched than were returned, so what you have is a page and not the whole set. | |
| depth_note | No | How far back the data behind this answer reaches. | |
| access_note | No | What this connection could not return and what lifts it. Always pass this on to the user: it is the only place that information appears. | |
| scan_capped | No | True when the search hit its own depth ceiling, so older matches may exist that were never looked at. | |
| scanned_rows | No | How deep the search went before filtering. Present only when a coin or size filter ran. |