com.coinlobster/whale-data

Tools

• big_catch

  The whale-flow setups the engine is tracking right now, each one coin in a state (forming, confirmed, accelerating) with its direction, catch type, severity, age and the price move since it fired. Use it for "what setups are live", "is there a setup on SOL", "what is the engine watching". Keyless returns the setups with their state and direction; Starter and up adds the score, its breakdown and the fire price. Descriptive, not a forecast. Descriptive market data only.

  shallow
• coin_brief

  The one-call answer for ONE coin, in causal order: price and 24h move, the news read (summary, mood, headlines), whale flow against its own normal, forced closes, funding and open interest, with recorded-history context. Answers "why is X moving" without a second call. view: brief (default), quick (price, funding, open interest only), funding (rate per exchange), crowding (0-100 crowding read, Pro).

  shallow
• coin_liquidations

  Forced closes ALREADY recorded for one pair, split long versus short. These are executed liquidations, not projected levels: for where liquidations could happen next use liq_zones, and for the whole market at once use market_liquidations. The plain-English name for liquidations (identical data and credit cost). Descriptive market data only.

  shallow
• coin_search

  Search the coin catalog by symbol or part of a name ("sol", "pepe", "render") and get the symbol the other tools take, whether this server streams it (streamed) and whether it is in the free set (free), with price, 24h change, volume and market cap where recorded. Use it first when a coin is unfamiliar or ambiguous, and for "which coins are ..." discovery. Free to call, same on every plan. Descriptive market data only.

  shallow
• crypto_news

  Recent crypto headlines with a pre-computed sentiment score (-100 to +100) for one coin plus the macro picture. Descriptive market data only.

  shallow
• defi_liquidations

  Lending liquidations from Aave V3 and Morpho Blue on Ethereum, Arbitrum and Base: a third party repaid the debt and seized the collateral, so both wallets are named on every row. A different event from a perp liquidation (see the liquidations tool) and never summed with one. count and total_usd cover exactly the rows returned and the window field states the period those rows span, so the total is never mistaken for a fixed 24h figure. Keyless. Descriptive market data only.

  shallow
• defi_summary

  One-call on-chain DEX state across Ethereum, Base and Arbitrum: 24h volume and TVL per chain, the highest-volume tokens, and whale swap activity (buy/sell split, unique and repeat wallets, per-DEX breakdown). Keyless returns totals and a short token list with swap USD withheld; a developer plan returns the full table. Descriptive market data only.

  shallow
• dex_board

  The wallets that moved the most size on DEXes across Ethereum, Base and Arbitrum in the last 48h, ranked, with buy and sell dollars, chains, token count and a behaviour classification; or, with token, the 24h whale-swap snapshot for one token. Use it for "who is moving size on chain", "biggest DEX traders this week", "who is trading PEPE on chain". Keyless returns the board with wallet addresses withheld; Starter and up names every wallet (pass one to dex_wallet). Descriptive market data only.

  shallow
• dex_wallet

  One Ethereum, Base or Arbitrum address: its recorded DEX swaps, net flow per token and activity pattern. For a Hyperliquid ACCOUNT use hl_wallet instead: the same 0x string can exist on both and they are different subjects with different pages. Real coverage limit, state it once when the answer turns on it: the swap feed sees roughly 7 percent of a wallet total activity, so quiet here does not mean inactive. Descriptive market data only.

  shallow
• flag_outcomes

  Recently fired signal-ledger flags with fire-time price and later price outcomes, logged live and never backfilled. Descriptive market data only.

  shallow
• funding_matrix

  Per-venue funding rates for one pair with predicted next rate and payout time where the venue provides it. Keyless on any streamed pair. Descriptive market data only.

  shallow
• history

  History for one coin. series: price (default: near-live hourly or daily bars, oldest first), funding_oi (the intraday open interest and funding path), daily (the recorded daily archive of funding, open interest, price and liquidations for the coin), whale_daily (the recorded daily whale buy and sell flow for the coin).

  shallow
• hl_board

  The tracked Hyperliquid whale accounts: equity, open notional, leverage, net bias, plus per-coin crowding across those wallets. Keyless returns the top rows and states how many are withheld; a developer plan returns the whole board. Descriptive market data only.

  shallow
• hl_moves

  What named Hyperliquid accounts just DID: open, add, trim, close or flip, with the coin, side, size of the change, the standing position after it, leverage and liquidation price. Use it for "what did the big accounts just do", "did anyone flip short on BTC", "what is Trader 7 doing". Keyless returns the proven-trader cohort's moves; a plan returns every tracked account at the plan's row cap. Filter by coin, wallet or kind; since_ms is a polling cursor. Descriptive market data only.

  shallow
• hl_traders

  Every Hyperliquid wallet that has closed a trade, screened from primary closing fills for net-of-fees realized profit and a human trade pace, so a profitable trader outside the venue's ranked leaderboard is still found. A stage-1 claim from fills alone: equity, ROI and the market-maker volume ratio are not verified, because a closing fill carries no account value, so it is a weaker and different claim than smart_money or hl:proven and is never the same number. Net realizedPnl sits next to its gross and fees, and profitableCloses counts distinct closing actions, not partial fills. Keyless returns the top rows and states how many are withheld; a developer plan returns the whole board. Descriptive market data only.

  shallow
• hl_wallet

  One Hyperliquid account: live positions, equity, leverage, net bias and unrealized PnL, plus its recent whale-sized fills. The live book is public on Hyperliquid so it stays keyless; computed history (win rates, cadence, realized PnL) and the full fill trail need a developer plan. Descriptive market data only.

  shallow
• hl_whales

  Recent whale-sized Hyperliquid fills WITH THE WALLET ADDRESS attached. Hyperliquid is the one venue whose public feed names the account on both sides of a fill, so every row here is followable to a live book (see hl_wallet). Keyless. Descriptive market data only.

  shallow
• liq_heat

  Where liquidations actually hit, by price band, in 5-minute columns: the realized heat grid for one pair, with the hottest cell named. Use it for "where did the liquidations cluster today", "which price band got hit hardest". Keyless: the free pairs, the last 3 hours (36 columns). Starter: every streamed pair. Pro: the 12-hour grid (144 columns) and the projected forward grid. For projected levels as a book use liq_zones; for the events themselves use liquidations. Descriptive market data only.

  shallow
• liq_zones

  Projected liquidation level book for one pair (modeled from leverage assumptions - clearly labeled as a projection, not executed trades). Keyless serves the free pairs without cascade chains; an active developer plan serves any pair with the full snapshot. Descriptive market data only.

  shallow
• liquidations

  Liquidation trades for a pair with the long and short breakdown, live tape merged with the recorded series so a restart never erases history. A long is force-closed by selling, so sell-side events are long liquidations. long_liquidations and short_liquidations are event COUNTS; long_usd and short_usd carry the dollar split. Pass hours to ask for a period (hours: 24 for today); without it you get the most recent rows and window_minutes tells you how far back they reach. truncated:true means more events matched than were returned, so window_minutes covers the returned rows only and total_in_window has the real count. Descriptive market data only.

  shallow
• market_brief

  A complete current market brief for ONE coin in a single call: price, cross-venue funding with carry, open interest, whale flow versus the coin's own baseline, recent liquidations and historical context. The plain-English name for trade_context (identical data and credit cost). Use for a general "what is happening with BTC / how is ETH positioned" question, and do not also call the separate whale, funding or liquidation tools unless the user drills into one of them. Descriptive market data only.

  shallow
• market_changes

  What changed across the market recently, in one call: the current risk regime, which coins whales are net buying and selling now, the coins that just turned unusual, the biggest movers, and the 24h forced-close picture (perp and lending kept separate). The same one-call brief market_digest serves on a timer, framed for an on-demand "what changed since this morning / overnight" question. Descriptive market data only.

  shallow
• market_digest

  One-call market brief for a scheduled or recurring run: current BTC risk regime, which coins whales are net buying and selling now, the coins on the Smart Money Radar, the biggest movers, and the 24h forced-close picture (perp and lending kept separate). No arguments; returns everything in one payload so an automation can ask it on a timer. Descriptive market data only.

  shallow
• market_extremes

  Which pairs sit at a record or in their own top or bottom 5 percent for funding, open interest or liquidations, each vs that pair's own recorded history, with next-day outcome stats for past occurrences where enough events exist. Covers the latest day the daily scan recorded, which is NOT necessarily today: read as_of_day and stale before describing any of it as current. Descriptive market data only.

  shallow
• market_history

  Daily history: funding rate, open interest, price and liquidation totals for one pair (archived since 2026-03-18), or daily whale buy/sell flow for one coin (since 2026-06-18). Keyless calls cover 30 days; a paid developer plan reaches the full archive. Descriptive market data only.

  shallow
• market_liquidations

  The whole market's forced closes in one call rather than per pair: 24h dollars and counts split long vs short, hour by hour so a cascade is locatable, ranked by coin, plus the biggest single event. Perp dollars come from the venues that publish a liquidation feed, not from every venue we stream, and the Hyperliquid share is a sample of that venue read from tracked wallets, so the totals are a FLOOR. Includes named_liquidations, the wallets that were closed out on Hyperliquid, which no other venue publishes. lending_liquidations rides alongside as a SEPARATE lane (an on-chain debt repaid and collateral seized) and must never be added to the perp numbers. A long is force-closed by selling, so long dollars are sell-side pressure. Descriptive market data only.

  shallow
• market_movers

  The biggest 24h gainers and losers across the streamed top-~300 board, each with price, 24h change and 24h volume (so a move on thin volume shows). Use this for momentum discovery ("which coins are moving most right now", "biggest gainers today", "what is pumping"). For WHY a coin is moving use market_brief; to cross-filter movers by another condition (price up but volume weak, up with negative funding) use market_screener; for unusual WHALE flow specifically use whale_radar. Descriptive market state, never a prediction. Descriptive market data only.

  shallow
• market_now

  The whole market in one call. view: changes (default: what changed since your last check or since_ms, ranked by how unusual, with plain state labels, what whales net bought and sold, coins that turned unusual, biggest movers, forced closes, the market news read; pass back next_since_ms on a timer), overview (totals, whale net flow, top coins; pass coin for one row), movers (24h gainers and losers with volume), extremes (pairs at a record or their own top or bottom 5% for funding, open interest or liquidations), defi (DEX volume and TVL per chain).

  shallow
• market_overview

  One-call market scan: totals (volume, OI, liquidations, mcap), 24h whale net flow, BTC risk regime (SMA20/50 + breadth), and the top rows by volume. Pass coin to get one symbol's row directly (no paging needed). Descriptive market data only.

  shallow
• market_screener

  Screen every recorded pair in one call: filter by funding_band / oi_band (vs each pair's OWN recorded days: record high, top 5%, top 25%, typical, bottom 25%, bottom 5%, record low), minimum whale-flow multiple vs the coin's own average, and radar-unusual. The discovery call. Descriptive market data only.

  shallow
• market_snapshot

  One-call market state for a pair: last price, 24h stats, average funding rate, open interest and recent liquidation totals from the venues that publish them. Keyless calls cover the free pairs; a paid developer plan covers every streamed pair. Descriptive market data only.

  shallow
• my_access

  What THIS connection can and cannot see: whether it is on the free plan (on_free_plan), how many credits are left and roughly how many more tool calls that buys, which tier it is on, the exact row cap and time window every tool applies to it right now, what is locked, and precisely what lifts each limit. Call it whenever the user asks what they get, how many credits they have, why a result came back capped (any payload carrying a capped field), or how and where to upgrade. Only an active developer plan lifts the caps here, and this settles the two things people get wrong most often: CoinLobster Pro ($15/mo) is the WEBSITE subscription and adds nothing here, and a free API key lifts no cap here either (it does give this connection its own rate limit instead of a shared one). Free to call and never metered.

  shallow
• my_alerts

  What YOUR alerts fired since a time: the rules on your CoinLobster account, the same history the site shows, newest first, with the move since each fired where a price was stored. Use it for "what fired for me overnight", "anything on my coins since this morning", "did my BTC alert go off". Needs a signed-in connection (free, no plan): keyless is refused by name. Free returns the counts per coin; Starter and up returns every fired row. Descriptive market data only.

  shallow
• news

  Headlines for one coin with the mood score (-100 to +100), the written points behind it and the market-wide read. For "why is X moving" use coin_brief: it already carries this.

  shallow
• oi_funding_history

  The intraday path of open interest and funding for one pair, aggregated across venues, oldest first. Use it for "how has BTC open interest moved today", "was funding rising into that move", "show me the OI path over the last 12 hours". Keyless: the free pairs, the last 24h at 1-hour resolution. Starter and up: every streamed pair at the recorded 5-minute resolution, up to the plan's window. For the daily archive use market_history. Descriptive market data only.

  shallow
• onchain_whales

  Executed DEX whale swaps on Ethereum, Base and Arbitrum, each carrying the wallet, the DEX, the token and the USD size. Filter by chain, coin or minimum size. Keyless. Descriptive market data only.

  shallow
• options

  The options picture for BTC or ETH from Deribit: total open interest, the strikes holding the most of it (the walls, which act as magnets into expiry), the put/call balance, max pain per near expiry, the implied-vol regime (DVOL), and recent large option trades. Aggregate market structure, keyless; the large-trade feed deepens on a paid plan. Descriptive market data only.

  shallow
• orderbook

  The order book for one pair merged across the streamed venues and aggregated by exact price: best bid and ask, the spread, and the dollars resting on each side in the top levels, with the venues holding each level. Use it for "where are the walls on BTC", "how deep is the bid", "what is the spread". Keyless reaches the free pairs at 5 levels; Starter any pair at 10; Pro 25. Descriptive market data only.

  shallow
• price_candles

  Near-live price bars (OHLCV) for a pair: interval "1h" (default) or "1d", oldest first, each bar { t, o, h, l, c, v }. This is the lane a bot reads to compute its OWN indicators (moving averages, momentum, whatever it wants), so CoinLobster does not need to ship them. NEAR-LIVE and separate on purpose from market_history, which is the daily archive that settles days behind: every reply carries newest_candle_age_min and stale so a live lane is never confused with a stopped one. Keyless covers the free pairs up to 168 bars; a paid plan covers every streamed pair up to 720 bars (asking for more returns the cap and says so in `capped`). The newest bar is still forming. Descriptive market data only.

  shallow
• proven_traders

  The Hyperliquid accounts screened for provable profit (equity, month and all-time PnL and ROI) and verified by their own fills to trade at a pace a person could follow, each with a trader number, its numbers and the coins it trades. Use it for "who are the best traders", "who is Trader 12", "which proven traders trade SOL". Same on every plan. For one account's live book use hl_wallet; for what they just did use hl_moves; for their collective book per coin use smart_money. Descriptive market data only.

  shallow
• sectors

  Where whale money is moving between sectors (L1, L2, DeFi, memes, AI and others): net direction, share of flow and the coins carrying it.

  shallow
• signal_outcomes

  Recorded signals with the price when each fired and the price afterwards, logged live and never backfilled: whether a whale, funding or other signal has historically led anywhere. The plain-English name for flag_outcomes (identical data and credit cost). Descriptive market data only.

  shallow
• signal_record

  How the last N firings of one signal type on one coin played out: how many rose over the next 24h and the median absolute move, the same numbers the site shows, plus the rows themselves. Use it for "how have funding-extreme flags on ETH worked out", "does the whale-spike signal on SOL lead anywhere". A record is stated only over enough clean samples; below that the rows are listed and no rate is claimed. Same on every plan. flag_outcomes is the market-wide ledger; this is one type on one coin. Descriptive market data only.

  shallow
• signals

  Signals logged live when they fired, never backfilled, with the price after. view: recent (default: the latest signals and their outcomes), record (the last N firings of one type on one coin: how many rose, median move), scorecard (the totals only).

  shallow
• situations

  What is going on right now, in stages: each live situation is one coin, one lane, one stage (emerging, confirmed, fading), with the evidence families behind it, the headline and the price move since it started. Use it for "what is going on with SOL", "what is developing right now", "anything building on my coins". Keyless returns the top situations with trimmed evidence; Starter returns every live situation with full evidence; Pro adds include_resolved for the outcomes of finished ones. Descriptive market data only.

  shallow
• smart_money

  What the PROVEN trader cohort is holding and trading, coin by coin. The cohort is not a guess at who is smart: it is Hyperliquid leaderboard accounts screened for provable profit (equity band, month and all-time PnL and ROI, volume-to-equity) and then verified against their own fills to trade at a cadence a person could follow. Two blocks, two different units, never added: positions_held is notional currently open, flow_traded is dollars executed inside the window (1h, 4h or 24h). Every row carries the wallet COUNT behind it and a thin flag when fewer than 3 cohort wallets are in it, because a one-wallet row is one person and not a cohort. cohort.rosterAgeHours is how old the MEMBERSHIP screen is (up to 24h), which is a separate fact from updated_at. Wallets whose live book could not be read are reported as unprofiled and are never counted as flat. Keyless. Descriptive market data only.

  shallow
• squeeze_score

  Fused 0-100 crowding read per pair (funding + long/short accounts + taker imbalance + OI trend) with the overexposed side. Descriptive, not a trade signal. Needs a paid developer plan. Descriptive market data only.

  shallow
• trade_context

  The pre-trade context blob in one call: price, cross-venue funding with time-to-next-funding and carry arithmetic (optional position_usd), open interest, whale flow vs the coin's own baseline, and recent visible liquidations, on ANY streamed pair keyless. compact: true returns the one-line composed answer (about 30 tokens). A paid developer plan adds the percentile judgment vs the pair's own recorded days, whale USD magnitudes, full 24h stats and the crowding score. Strictly descriptive: state plus recorded history, no advice. Descriptive market data only.

  shallow
• traders

  Smart money here means the PROVEN cohort: Hyperliquid accounts screened for real profit and verified by their own fills. view: smart_money (default: what that cohort holds and trades per coin), proven (who they are, by trader number), screened (every wallet screened from closing fills, a weaker claim), board (tracked big accounts: equity, leverage, bias), moves (opens, adds, trims, closes, flips just now), dex (wallets moving the most on DEXes).

  shallow
• wallet

  One address. A Hyperliquid account returns its live positions, leverage, liquidation prices and recent fills; an Ethereum, Base or Arbitrum wallet returns its DEX swaps and net flow per token. chain: auto (default: tries Hyperliquid, then on-chain), hyperliquid, or evm.

  shallow
• watch

  Alerts checked continuously and posted to your webhook when they trigger. action: list (default), create (coin + trigger: radar_unusual, flag_fired or funding_band with band, + webhook_url), delete (id). Starter and up to create.

  shallow
• watch_create

  Arm an alert on one coin that the backend evaluates continuously and posts to your webhook when it fires: radar_unusual (whale flow turns unusual versus the coin's own normal), flag_fired (a signal fires on the coin), or funding_band (funding enters a recorded-days band, pass band). The one tool that makes an agent come back: use it for "tell me when", "alert me if", "watch BTC for". Pro and up; below that the answer names the plan. The webhook must be a public https URL you control. Descriptive market data only.

  shallow
• watch_delete

  Remove one alert this connection armed, by the id watch_list or watch_create returned. Free to call. Descriptive market data only.

  shallow
• watch_list

  The alerts this connection has armed with watch_create: id, coin, trigger, band, webhook, active state and failure count. Free to call. Alerts armed over the REST API with an API key are listed there, not here. Descriptive market data only.

  shallow
• watchlist_brief

  Every coin on your CoinLobster watchlist run through the whale read in one call: whale flow versus each coin's own normal, buy or sell lean, and whether it is on the radar as unusual right now. Use it for "how are my coins doing", "anything unusual on my watchlist", "brief me on my list". Needs a signed-in connection (free, no plan): keyless is refused by name. Free returns direction and the unusual flags; Starter and up adds the dollar flow per coin. Up to 10 coins per call for everyone. Descriptive market data only.

  shallow
• whale_activity

  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.

  shallow
• whale_context

  Per-coin whale flow vs that coin's OWN logged history: multiple of its daily average, N-day-high flags, buy share now vs 7d. The "is this unusual for THIS coin" call; coin accepts a comma-separated list for portfolio briefs (single coin returns a flat object; a list returns {coins:[...]}). Keyless returns multiples and records (USD magnitudes need an active developer plan). Descriptive market data only.

  shallow
• whale_flow

  Hourly buy and sell USD flow buckets for one coin, CEX and DEX split, over a rolling window. Descriptive market data only.

  shallow
• whale_profile

  Everything the recorded whale record can say about ONE coin in a single call: net flow over 1h, 4h, 24h and 7d; the CEX, on-chain and Hyperliquid split; WHICH of the 15 streamed CEX venues the flow actually sits on and how concentrated it is; whether two venues sit on opposite sides (venues.split) or the CEX and on-chain markets disagree outright (sources.sourceSplit); the current run of same-direction hours; and flow measured against price. pressure.state is one of absorption (whales bought while price fell), distribution (sold while it rose) or confirming (flow and price agree). It is null with a NAMED reason (price-coverage, flow-too-small, price-flat) whenever a leg is too thin to judge, so an absent verdict must be reported as "not enough to say", never as "no activity". venues.partial marks a window containing hours recorded before per-venue dollars existed, whose venue dollars are UNKNOWN and must not be read as zero. A window states hoursCovered ONLY when it holds fewer hours than it spans, so a 3-of-24 figure is never presented as a 24h figure; full windows carry no such field and need no disclaimer. Price-coverage figures are not sent when the pressure verdict already required them to pass, so there is nothing there to hedge with: a real shortfall arrives as a caveat field instead. Keyless (7-day window; a developer plan reaches the full 30-day record). Descriptive market data only.

  shallow
• whale_radar

  Smart Money Radar: which coins have unusual whale flow right now, across 1h, 4h and 24h windows. Descriptive market data only.

  shallow
• whale_sectors

  Where whale money is moving between sectors (L1, L2, DeFi, memes, AI and the rest) in the radar window: net direction per sector, its share of tagged flow and the coins carrying it. Use it for "which sectors are whales rotating into", "is money leaving memes". Keyless returns direction, share and coins; Starter adds the dollars. Descriptive market data only.

  shallow
• whale_tape

  Deprecated alias for whale_trades, kept so existing clients keep working. Prefer whale_trades. 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 50 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.

  shallow
• whale_trades

  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 50 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.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/50c6b5d1-9b1f-40cd-bb20-19827086222e/badge.svg)](https://vouch.tools/servers/50c6b5d1-9b1f-40cd-bb20-19827086222e)