Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Added "get_lighter_liquidation_map" and "get_lighter_whales" (37 tools before, 39 now)
[measured] Liquidation map for Lighter (zk perp DEX), not a model: leveraged positions of the accounts we have read, binned by Lighter's own liquidation price, long/short notional per bin, cumulative curves, the largest positions and the share of the venue's open interest covered. Accounts are discovered from the public trade stream, so coverage grows with time. range: 12h | 1d | 3d | 7d | max.
[measured] Leveraged positions on Lighter with the exchange-reported liquidation price, closest to liquidation first (sort='value' = largest first). Filters: coin (BTC), side (long|short), min_usd, max_dist_pct. address is the Lighter account index, l1_address the wallet. Snapshot age is in age_s.
Added "get_hl_builder_markets"; changed the definition of "delete_alert", "get_footprint", "get_funding_history" and 8 more (36 tools before, 37 now)
DeletePermanently delete one webhook alert subscription. DESTRUCTIVE and not reversible: deliveries to its URL stop at once and its signing secret is discarded (create_alert issues a new one). Only a subscriptionofownedthisby the caller's API key can be deleted; an id belonging to another key returns {"deleted": false} and changes nothing. id: the number returned byid.create_alert or list_alerts. Needs a Pro or Bot key (X-API-Key header of the MCP connection, or api_key).
Added "create_alert", "delete_alert", "get_history" and 3 more; changed the definition of "get_liquidations" (30 tools before, 36 now)
Recent liquidation events (side, price, qty),acrossNEWESTexchangesFIRST,overatthe lastmost`minutes``limit` rows (1-1440max 2000). Market-wide, 500 rows is only a few minutes of a busy hour: pass `symbol` (BTCUSDT) and/or `min_usd` to look further back, or use get_liquidations_summary for totals and get_history for the archive. side=long means a long position was liquidated.
Added "get_api_key" (29 tools before, 30 now)
Get a free LiquidVision API key for this agent's owner, by email, without a browser. Works for a NEW email only (an existing account's key is never returned; its owner sees it at liquidvision.app/data). Use the key as X-API-Key on REST or on this MCP endpoint for 300 req/min instead of the shared anonymous budget, and to upgrade later to Pro/Bot (history exports, webhook alerts). Ask the user for the email first; do not invent one.
Certificate recorded, valid to 2026-10-17
Authorization not required
Unknown → Live
First tool surface recorded: 29 tools (server version 1.30.0)
https://liquidvision.app/mcp (mcp_streamable_http) — from mcp_registry, with the record
Showing the latest 9 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
Order-flow[measured]footprintFootprint chart data: foraeachcorecandle,perptakersymbol:BUYperandcandletakerxSELL volume in USD and the trade count at each of 30 pricebinlevels, from the archived trade streams oftakerBinance,buy/sellBybit,USDOKX,volumeBitget anddeltaGate.(BinanceUse+itBybitto see at which prices aggressive buyers or sellers were absorbed; for the net flow over time by tradestreams).size use get_cvd. symbol: BTCUSDT, ETHUSDT or SOLUSDT only. minutes: look-back window, 15 to 10080. step: candle size in minutes, 1 to 240.
Bucketed[measured]funding-rateFundinghistoryrate over time for one contract, one row per venue per time bucket: ts (ms), exchange,forfunding_rate (per settlement interval, asymbolfraction), mark_price and funding_hours (e.g.thatBTCUSDTcontract's interval: 1, 4 or 8). Annualize as rate * 8760 / funding_hours. This is the LIVE predicted rate sampled over time; for thelastrates`minutes`actually paid at each settlement (5-201602 years back).use get_funding_settlements. symbol: BASEUSDT. minutes: 5 to 20160.
⟨5 unchanged words⟩ not a model: leveraged positions of the~300010,000 largest accounts binned by the exchange-reported liquidation price ⟨33 unchanged words⟩
Only numbers and dates differ: this server embeds live figures in the definition, so the text moves without the contract changing.
[measured] Leveraged positions of the300010,000 largest Hyperliquid accounts with the exchange-reported liquidation price ⟨31 unchanged words⟩
[modeled]LiquidationHowheatmapthe liquidation map evolved over time: grid[t][b] is the estimatedclusterUSDintensityof leveragedperpositions with their liquidation price in price binoverb at time(gridcols[timet] (ms), bins[binb] is the bin's centre price (240 bins fitted to the traded range)withand price[t] is the close. A level disappears once pricepath.trades through it. Use get_liquidation_map for the current picture only (smaller answer, split by leverage and exchange); use this one to see when a cluster formed and whether it is still there. The answer is large (about 35,000 numbers). symbol: BASEUSDT. exchange: all | binance | bybit | okx. range: 12h | 1d | 3d | 7d.
⟨4 unchanged words⟩ a perp symbol (e.g. BTCUSDT): estimatedliquidation-clusternotional of leveraged positions per price bin,at their liquidation price, split by leverage tier(10x/25x/50x/100x5/10/20/25/50/100x) and by exchange (binance/bybit/okxor 'all'), pluscumulative long/short curves from the current price outward. range: 12h | 1d | 3d | 7d.ValidationItvsanswersrealized"ifliquidationsprice reaches this level, how much is there" (backtest:seetop quarter of the levels price traded held 32% of the liquidated USD, chance 25%); it does NOT predict where price will go. Live scoring: get_accuracy.
Aggregated market-wide[measured]liquidationLiquidationstatstotalsoverfor thelastwhole`minutes`market, already added up: rekt (USD1h/4h/12h/24hliquidatedtotalsin the last 1h/4h/12h/24h, split long/short),per-symbolby_symbol andper-exchangeby_exchange overbreakdownsthe last `minutes`, and series (30-minute buckets). Start here for "how much was liquidated"; use get_liquidations for the individual orders and get_liquidation_cascades for events. Totals are a30-minfloor:timeBinance and Bitget throttle their feeds. side=long means longs were liquidated. minutes: 1 to 1440, applies to the breakdowns and the series.
[measured] Open interesttimeoverseriestime foraonesymbolcontract, one row per venue per time bucket: ts (e.g.ms),BTCUSDTexchange, oi (coins, one side),overoi_usd. Use it to see how positioning built up or unwound; for thelastcurrent snapshot with shares and 1h/4h/24h changes use`minutes`get_oi_board, for every contract at once get_open_interest. symbol: BASEUSDT (5-10080BTCUSDT). minutes: look-back window, 5 to 20160 (14 days); snapped to a fixed set of windows.
Order[measured]bookRestingliquiditylimitheatmapordersgridover time on ONE exchange: cells of (timexbucket, price bucket,bucketsquantity in coins) from archived order-book snapshots, withrestingprice_min, price_max,quantityprice_step and time_step (seconds)fordescribingonetheexchangegrid. Shows where bid and ask walls stood and when they were pulled; not liquidations (binance/bybit/okxsee get_liquidation_heatmap for those) andsymbolnot(e.g.tradesBTCUSDT(get_footprint). exchange: binance | bybit | okx. symbol: BTCUSDT, ETHUSDT or SOLUSDT only. minutes: 1 to 1440.
AlertThe webhook alert subscriptionsofthatthisbelong to the caller's API key (read-only): id, type,withurl, filters (symbol, min_usd, x_normal, max_dist_pct) and deliverystatushealth: last_status (last_statusHTTP code or error of the last delivery), fails,active(consecutive failures; a subscription pauses itself at 20).and active. Call it to find the id for delete_alert or to check why alerts stopped arriving. Needs a Pro or Bot key, from the MCP connection's X-API-Key header or the api_key argument; without one it returns an error object, not an exception.
[measured] Perp markets deployed on Hyperliquid by third parties (HIP-3 builder dexs): equity indices, single stocks, commodities and pre-IPO names such as xyz:SP500 or xyz:GOLD. For each dex: its markets (coin named dex:COIN), open interest in USD (one side), 24h volume, mark price, hourly funding and its APR. These are NOT in get_open_interest or get_funding_rates, which cover Hyperliquid's own crypto listing. Live from Hyperliquid, cached 2 minutes. No arguments.
{"properties":{"limit":{"default":500,"title":"Limit","type":"integer"},"min_usd":{"default":0,"title":"Min Usd","type":"number"},"minutes":{"default":60,"title":"Minutes","type":"integer"},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Symbol"}},"title":"get_liquidationsArguments","type":"object"}
Subscribe an HTTPS URL to push alerts instead of polling (Pro: 3, Bot: 20 subscriptions). type='cascade': a liquidation cascade just ended, over min_usd and x_normal times the coin's normal minute. type='hl_near_liq': a Hyperliquid whale position over min_usd within max_dist_pct of its liquidation price. type='cluster_sweep': price reached one of the 10 largest modeled liquidation-map clusters (size over min_usd; no symbol = BTC, ETH, SOL), sent 3 min later with modeled vs actually liquidated USD. Returns the signing secret ONCE: verify header X-LiquidVision-Signature …
Delete one alert subscription of this key by id.
[measured] Historical rows as CSV, for backtests. dataset: liquidations | funding_settlements (since 2024-09) | funding_hourly | open_interest_hourly | hl_positions (Hyperliquid whale positions with liquidation prices). start/end are ISO dates (UTC). Without a key or on the free tier only the last 24 hours are available; Pro: any 31-day window; Bot: full history. The key is read from the MCP connection's X-API-Key header, or pass api_key. limit caps rows here (max 5000); for bulk use download_url with the same key.
[measured] One Hyperliquid account by address: live positions (size, entry, mark, liquidation price, distance to liquidation, leverage, unrealized PnL), account value, and its archived position snapshots. History depth: 24 h free, 31 days Pro, everything since 2026-09-27 on Bot (key from the MCP connection's X-API-Key header, or api_key).
[measured] Leveraged positions of the 3000 largest Hyperliquid accounts with the exchange-reported liquidation price, closest to liquidation first (sort='value' = largest first). Filters: coin (BTC), side (long|short), min_usd, max_dist_pct. Each row carries the account address; pass it to get_hl_account. Snapshot age is in age_s.
Alert subscriptions of this key, with delivery status (last_status, fails, active).