What whales are doing with one coin
whale_activityRead-onlyIdempotent
Everything the recorded whale record can say about ONE coin in one call: net flow over 1h, 4h, 24h and 7d, the CEX / on-chain / Hyperliquid split, which of the 15 streamed CEX venues hold it, and flow measured against price. The plain-English name for whale_profile (identical data and credit cost), and the first tool for a general "what are whales doing with SOL" question. Descriptive market data only.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| coin | No | Coin symbol, for example BTC. A pair like ETH/USD works too, the quote leg is dropped. Required: with nothing to look up the call is refused rather than answered about a different coin. | |
| pair | No | Alias for coin. | |
| hours | No | How far back to read the record (min 168, i.e. 7 days). The reported windows are always 1h, 4h, 24h and 7d. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| coin | No | The coin this profile describes. | |
| note | No | One line saying what the numbers cover, or why there are none. Read it before reporting any zero as a market reading. | |
| 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. | |
| caveat | No | A real limit on this answer, in one clause. Present only when something genuinely narrows what can be said. | |
| venues | No | Which of the streamed exchanges the flow actually sits on and how concentrated it is. split marks two exchanges on opposite sides; partial marks a window whose exchange dollars are unknown rather than zero. | |
| sources | No | The CEX, on-chain and Hyperliquid split, including sourceSplit when those markets sit on opposite sides. | |
| summary | No | The answer in one plain sentence, computed from the fields below. Open the reply with this, then let the numbers back it up. Null only when there was nothing to summarise. | |
| windows | No | Net flow per window, keyed 1h, 4h, 24h and 7d. A window states hoursCovered only when it holds fewer hours than it spans. | |
| coverage | No | How much of the window carries a recorded reading. | |
| pressure | No | Flow measured against price. state is absorption, distribution or confirming. When there is no state, reason names why (price-coverage, flow-too-small, price-flat), which means not enough to say, never no activity. | |
| 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. | |
| 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. |