CoinLobster/agent-skills / skills/whale-flow
whale-flow
VerifiedLive crypto whale trades and net buy/sell flow across 15 exchanges plus Ethereum, Base and Arbitrum DEXs. Use when the user asks what whales or smart money are doing on a specific named coin: large trades, buy or sell flow, or who is accumulating or dumping BTC, ETH, SOL or any coin. For screening which coins look unusual use whale-radar; for a full why-is-it-moving diagnosis use crypto-market-snapshot. Free, no API key.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.8 KB |
| references/endpoints.md | markdown | 3.7 KB |
references/endpoints.md
View on GitHub# CoinLobster keyless endpoints used by this pack
All GET, JSON, no auth. Rate limit: 60 requests/min per IP on `/api/public/*`; the
61st returns 429. The MCP has its own layered budget, so back off on `Retry-After`
rather than assuming a rate. Be polite anyway: one call per question, not per
token. Base: `https://coinlobster.com`
## REST
| Endpoint | Params | Returns |
| --- | --- | --- |
| `/api/public/crypto-whales` | `coin` (base symbol, e.g. BTC), `limit` (max 100 keyless) | `whales[]`: pair, exchange, price, quantity_base, quantity_quote (USD), isBuy, timestamp (ms), `marketConditions` (funding + OI across venues at trade time). CEX lane only. |
| `/api/public/onchain-whales` | `chain` (ethereum\|base\|arbitrum), `limit` (max 200; keyless returns up to 10 teaser rows, $250K+ only) | `whales[]`: tokenSymbol, amountUsd, isBuy, dex, chain, txHash, timestamp |
| `/api/public/hyperliquid/whales` | `coin`, `limit` | Hyperliquid whale fills with the wallet address attached (free = $1M+ prints, 10-row teaser) |
| `/api/public/whale-flow-history` | `coin` (default BTC), `hours` (24 to 168 keyless; 720 on a coinlobster.com website subscription, which an API key does not grant. For 30 days on an agent surface use the `whale_flow` MCP tool on a developer plan.) | `rows[]`: { t, buyUsd, sellUsd, netUsd, count, price }, hourly flow on the same grid as the hourly close, plus `coverage` { hoursReturned, hoursWithPrice }, `maxFreeHours` (168) and `proHours` (720). The REST twin of the `whale_flow` tool. `available: false` = no recorded whale hours for that coin yet. |
| `/api/public/whale-radar` | `window` (1h\|4h\|24h) | `rows[]`: coin, direction, unusual, count. Keyless keeps magnitudes on the free pair (BTC) only; other unusual coins come back `blurred: true`, and locked coins that are not unusual are omitted. |
| `/api/public/receipts/:type/:coin` | path params, e.g. `/whale-spike/BTC` | past firings of one signal type on one coin with price outcomes |
| `/api/public/overview` | `q` (search base symbol or name), `limit` (max 200), `offset` | market totals, regime, BTC price, whale net 24h, and `page` { total, offset, limit, rows[] }. Use `q` to find one coin; do not page for it. |
## Markdown mirrors (fetch and read, no parsing)
- `/crypto-whales.md`: latest whale trades table
- `/radar.md`: unusual flow now + recent flag outcomes
- `/whale-statistics.md`: market-wide whale stats
## MCP over plain curl (works from any shell, no MCP client needed)
The hosted MCP accepts raw JSON-RPC; useful where a tool exists but no REST twin does
(liquidations, market_snapshot):
```bash
curl -s -X POST https://coinlobster.com/mcp \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"liquidations","arguments":{"pair":"BTC/USD"}}}'
```
## Lifting the caps
A free API key (a one-off 1,000 credits: https://coinlobster.com/developers) unlocks the
keyed REST endpoints `/api/ai/v1/*` (history to 400 days, credit-metered). It
does NOT lift the live MCP caps. The full live feed on every pair, radar
magnitudes, non-BTC `market_snapshot` and 30-day flow windows need an active
developer plan (Builder $29/mo, Growth $99, Scale $249). One plan covers both
full-depth MCP and the REST credits, on one shared account balance. Send the key
as `X-API-Key` on the MCP or `Authorization: Bearer` on `/api/ai/v1/*`.
On an active developer plan each successful tool call spends 40 to 100 credits
(2x the mirrored REST cost) from the plan's balance. Keyless calls, discovery
and failed calls cost nothing.
CoinLobster Pro ($9/mo) is the coinlobster.com website subscription (live feed,
alerts, whale radar). It grants no MCP depth and no API access.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |