Whale flow alerts (recent large moves)
hl_whale_flow_alerts[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Recent large changes in whale cohort positioning: which coins saw net long/short notional shift beyond a USD threshold within a lookback window — 'who opened/closed what in the last hour'. Detects full exits. Seeds a baseline on first call. Analytics only, not investment advice.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "hl_whale_flow_alerts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dex | No | Perp dex: omit for the main dex, a HIP-3 builder dex name (e.g. 'xyz'), or 'all' for every dex (at most 20 wallets). | |
| topN | No | ||
| cohort | No | Explicit 0x wallet addresses; else HL_WHALE_ADDRESSES. | |
| thresholdUsd | No | Min absolute net-notional change to alert on. | |
| lookbackMinutes | No | Compare against a snapshot ~this old. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dex | Yes | ||
| alerts | Yes | ||
| source | Yes | ||
| disclaimer | Yes | ||
| baselineFound | Yes | ||
| walletsQueried | Yes | ||
| lookbackMinutes | Yes | ||
| walletsCappedTo | Yes | ||
| walletsRequested | Yes |