Whale Data MCP Server

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.

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.

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.

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.

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). The free plans cover the last day; a paid plan reaches the full archive. Descriptive market data only.

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.

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.

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.

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.

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. On the free plans BTC answers in full and any other coin as a headline; a paid plan covers every streamed pair in full. Descriptive market data only.

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.

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:[...]}). USD magnitudes included; on the free plans a coin other than BTC gets a headline. Descriptive market data only.

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

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. On the free plans BTC over the last 24 hours and any other coin as a headline; a paid plan reaches the full 30-day record. Descriptive market data only.

Which coins have UNUSUAL whale flow right now, each measured against its OWN trailing baseline, across 1h, 4h and 24h windows. Use this to DISCOVER coins worth a look when the user has not named one ("what looks unusual", "what are whales into right now", "anything moving under the radar"). Ranks by how far above a coin's normal, not by dollar size, so a smaller coin can top a larger one. For ONE named coin use whale_profile (or whale_activity); to ask whether a named coin's flow is unusual FOR THAT COIN use whale_context; for a full market brief use market_digest. No arguments. Descriptive market data only.

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.

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. The free plans get the free shape (BTC/USD + $1M+ CEX trades live, other pairs delayed 30 min, DEX swaps $250K+) up to 25 rows from the last 24 hours, and a headline when a coin other than BTC is named; a paid 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.

Live whale trades merged across 15 CEX venues plus on-chain DEX swaps (Ethereum, Base, Arbitrum), newest first. The free plans get the free shape (BTC/USD + $1M+ CEX trades live, other pairs delayed 30 min, DEX swaps $250K+) up to 25 rows from the last 24 hours, and a headline when a coin other than BTC is named; a paid 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.

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". Starter and up; below that the answer names the plan. The webhook must be a public https URL you control. Descriptive market data only.

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

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.

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.

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.

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.

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). Use this for the DeFi / on-chain picture ("what is happening in DeFi", "which chain has the most volume", "where is capital moving on chain"). For the individual wallets behind large swaps use onchain_whales; for CEX whale flow use whale_profile. Keyless returns totals and a short token list with swap USD withheld; a paid plan returns the full table. Descriptive market data only.

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.

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.

Per-venue funding rates for one pair, side by side, with the predicted next rate and payout time where the venue provides it. Use this when the user asks about funding across exchanges, where funding is most extreme, or where perp longs vs shorts are paying ("compare BTC funding across venues", "which venue has the richest funding"). For the single average funding on a coin alongside price/OI/whales, market_brief already includes it; for whether funding is unusual vs the coin's history, market_history/market_extremes carry the comparison. On the free plans BTC in full and any other pair as a headline. Descriptive market data only.

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.

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.

Projected liquidation level book for one pair (modeled from leverage assumptions - clearly labeled as a projection, not executed trades). The free plans get BTC without cascade chains and a headline for any other coin; an active paid plan serves any pair with the full snapshot. Descriptive market data only.

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.

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.

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 paid plan lifts the caps here (one subscription works across the website, your AI and the REST API on a shared credit balance), and this settles the thing people get wrong most often: a free API key lifts no cap here either (it gives this connection its own rate limit instead of a shared one, and unlocks the metered REST endpoints, but changes nothing in here). Free to call and never metered.

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.

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.

The tracked Hyperliquid whale accounts: equity, open notional, leverage, net bias, plus per-coin crowding across those wallets. Use this for how the tracked HL whales are positioned right now ("are HL whales long or short BTC", "what are the big HL accounts in"). For one specific wallet use hl_wallet; for the proven-profitable trader cohort use smart_money or hl_traders; for individual recent fills use hl_whales. Keyless returns the top rows and states how many are withheld; a paid plan returns the whole board. Descriptive market data only.

Recent crypto headlines with a pre-computed sentiment score (-100 to +100) for one coin plus the macro picture. Use this when a move might be NEWS-driven, or when the user asks what is being said about a coin ("any news on SOL", "why is ETH moving, is it news"). Reach for this AFTER the market read (market_brief / whale flow / liquidations) has ruled out a market-structure cause, so news is offered as one candidate explanation, never asserted as the reason. Descriptive market data only.

Recently fired signal-ledger flags with fire-time price and later price outcomes, logged live and never backfilled. For one signal type on one coin (how the last N played out) use signal_record.Descriptive market data only.

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.

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.

Executed DEX whale swaps on Ethereum, Base and Arbitrum, each carrying the wallet, the DEX, the token and the USD size. Use this to see WHO is swapping large size on chain and in what ("which wallets are buying PEPE", "large DEX swaps today"). Filter by chain, coin or minimum size. For chain-level DeFi totals use defi_summary; for one address's full history use dex_wallet; for CEX whale flow use whale_trades. Keyless. Descriptive market data only.

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.

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.

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

The Hyperliquid accounts screened for profit on Hyperliquid's own leaderboard figures (equity, month and all-time PnL and ROI, which can include open positions) 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". With no coin filter it is the same on every plan; on the free plans a coin filter other than BTC gets a headline. 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.

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.

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.

A fused 0-100 crowding read for one pair (funding + long/short accounts + taker imbalance + OI trend) with the overexposed side. Use this when the user asks how crowded or squeeze-prone a coin is, or which side is over-leveraged ("how crowded is BTC", "is ETH set up for a long squeeze"). For WHERE forced closes would land use liq_zones; for forced closes that already happened use liquidations/market_liquidations. Descriptive, never a trade signal or a prediction. Needs a paid plan. Descriptive market data only.

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 (on the free plans BTC in full and any other pair as a headline). compact: true returns the one-line composed answer (about 30 tokens). The percentile judgment vs the pair's own recorded days is keyless everywhere; on a pair outside the free set Starter adds the full 24h stats and whale USD magnitudes, and Pro adds the crowding score (locked_layers names what this plan withheld). Strictly descriptive: state plus recorded history, no advice. Descriptive market data only.

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 the proven-trader board 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 paid plan returns the whole board. Descriptive market data only.

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 on the free plans; computed history (win rates, cadence, realized PnL) and the full fill trail need a paid plan. Descriptive market data only.

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.

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. Use this to see which named accounts just traded a coin ("which HL whales just bought BTC"). For one wallet's full book and leverage use hl_wallet; for the ranked tracked-account board and net bias use hl_board; for the proven-profitable cohort use smart_money. Keyless. Descriptive market data only.