Crypto derivatives data and answers for AI agents: smart money, liquidations, funding, 13 venues
Connect Remote server
claude mcp add --transport http derivatives https://liquidvision.app/mcp --header "X-API-Key: <X_API_KEY>"{
"mcpServers": {
"derivatives": {
"url": "https://liquidvision.app/mcp",
"headers": {
"X-API-Key": "<X_API_KEY>"
}
}
}
}{
"servers": {
"derivatives": {
"type": "http",
"url": "https://liquidvision.app/mcp",
"headers": {
"X-API-Key": "<X_API_KEY>"
}
}
}
}Settings > Connectors > Add custom connector
URL: https://liquidvision.app/mcpReplace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools 69 found in our last check
list_markets[measured] What exists: every venue we track and, for each, the contracts with live open interest right now (BASEUSDT symbols), plus the top-100 coin pool. Call this first when unsure which symbol or exchange string another tool accepts.
get_accuracy[measured] The public accuracy audit: our open interest and funding vs Binance, Bybit, OKX and Hyperliquid's own endpoints, sampled every 10 min (diff %, snapshot age, 24h mean/max), plus how the modeled liquidation map scored against realized liquidations. Read this before trus…
get_funding_ratesLatest perpetual funding rates and mark prices for every tracked exchange/symbol pair. Positive rate = longs pay shorts.
get_microstructureCross-venue order book microstructure for BTC, ETH and SOL. Per venue: spread in bps, immediately-executable depth in USD and the bid share of it, measured over a band narrow enough that every venue's stream captured it, each venue around its own mid. Also the basis - how far ap…
get_positioning_regimePer-coin positioning regime from price direction crossed with open interest. price up + OI up = new longs; price up + OI down = short covering (a rally with no new buyers); price down + OI up = new shorts; price down + OI down = long flush. Returns a market summary (coins and ne…
get_liquidation_cascades[measured, PAST] Liquidation CASCADES as discrete events: bursts of liquidations detected against each coin's own 7-day normal minute. Use it for "when did forced selling snowball and what did price do"; not for totals (get_liquidations_summary), raw orders (get_liquidations) or…
list_history_packages[measured] Monthly Parquet history packages for backtests: liquidations (11 venues), funding hourly and settlements, open interest hourly, Hyperliquid and Lighter positions with liquidation prices — one file per dataset per month since 2026-07 with rows, bytes and sha256. Each e…
get_funding_arbitrage[measured] Funding carry screener on REALIZED numbers, out of sample: for each coin, the venue pair a desk would have put on a week ago (short where funding WAS richest, long where it was cheapest, chosen on days 14-7 ago: selection_week_apr) and what that pair then earned from…
get_funding_dispersionCoins ranked by how far funding disagrees ACROSS exchanges. For each coin: the spread in APR points between the venue charging the most and the one paying the most, plus which venue to hold the long on and which to hold the short on. Every leg is annualized with its own settleme…
get_funding_settlementsSettled funding rates, one row per settlement, from Binance and Bybit history — up to 730 days for any pool coin (e.g. BTCUSDT). The backtest series; get_funding_history is the live 10-second archive since July 2026.
get_open_interestLatest open interest (contracts and USD) per exchange/symbol.
get_open_interest_history[measured] Open interest over time for one contract, one row per venue per time bucket: ts (ms), exchange, oi (coins, one side), oi_usd. Use it to see how positioning built up or unwound; for the current snapshot with shares and 1h/4h/24h changes use get_oi_board, for every cont…
get_funding_history[measured] Funding rate over time for one contract, one row per venue per time bucket: ts (ms), exchange, funding_rate (per settlement interval, a fraction), mark_price and funding_hours (that contract's interval: 1, 4 or 8). Annualize as rate * 8760 / funding_hours. This is the…
get_long_short_ratioLatest global long/short account ratio per exchange/symbol.
get_liquidations[measured, PAST] Individual liquidation ORDERS that already happened (side, price, qty), newest first, at most `limit` rows (max 2000). This is the raw feed: use it when you need the orders themselves. For totals use get_liquidations_summary; for cascades as events use get_liqui…
get_liquidations_summary[measured, PAST] TOTALS of liquidations that already happened: rekt (USD liquidated in the last 1h/4h/12h/24h, split long/short), by_symbol and by_exchange over the last `minutes`, and series (30-minute buckets). The one to call for "how much was liquidated"; it does not return…
get_oi_boardPer-venue open-interest ranking for a perp symbol (e.g. BTCUSDT): OI in coins and USD, market share %, 1h/4h/24h OI change % and USD flow, and OI / 24h-volume ratio per exchange, plus market totals.
get_cash_flowsDerivatives cash flow per exchange: net USD into/out of open interest over 1h/4h/24h windows, per core symbol. Positive = money flowing in.
get_arbitrum_perpsArbitrum perps board: GMX v2 open interest per coin and its share of every tracked venue, GMX funding next to the CEX median (8h basis), on-chain liquidations over 24h. Ask this for 'how is Arbitrum positioned vs CEXs'.
get_top_tradersTop traders on OKX copy trading, Hyperliquid and GMX (public data, free): total PnL, win rate, AUM, copiers, live open positions (pair, side, leverage, entry, uPnL) and recently closed trades with realized PnL. For a ranked list of consistently profitable Hyperliquid wallets wit…
get_token_unlocksUpcoming token unlock events for pool coins, nearest first: next unlock timestamp and token amount per public vesting schedule.
get_stocksCrypto-related equities (COIN, MSTR, miners) and spot BTC/ETH ETF quotes: price, day change %, range, volume. ~15-min delayed.
get_liquidation_map[modeled, RISK AHEAD, CEX, now] ESTIMATED open leveraged positions on Binance/Bybit/OKX per price bin at their liquidation price, from candles and open-interest deltas (the CEXs do not publish positions). Current snapshot only; for its evolution over time use get_liquidation_hea…
get_hl_liquidation_map[measured, RISK AHEAD, Hyperliquid] REAL open positions on Hyperliquid binned by the liquidation price the exchange itself reports: the 10,000 largest accounts plus every account seen trading since the reader started (about 13,600 accounts, ~40-45% of venue open interest, stated…
get_liquidation_heatmap[modeled, RISK AHEAD, CEX, over time] The same estimated CEX map as get_liquidation_map but as a time series: grid[t][b] is the estimated USD of leveraged positions with their liquidation price in price bin b at time cols[t] (ms), bins[b] the bin's centre price (240 bins fitted…
get_orderbook_heatmap[measured] Resting limit orders over time on ONE exchange: cells of (time bucket, price bucket, quantity in coins) from archived order-book snapshots, with price_min, price_max, price_step and time_step (seconds) describing the grid. Shows where bid and ask walls stood and when…
get_market_briefDeterministic market brief for a perp symbol: 24h liquidations (totals, by exchange), current funding + 24h extremes per venue, OI by venue with 1h/4h/24h changes, net position flows, modeled liquidation risk zones above/below price, and top-trader positioning. Free, no LLM invo…
askONE CALL instead of five: ask in plain words ('where is leverage stacked on BTC', 'why did ETH drop', 'is SOL funding crowded', 'biggest whales near liquidation') and get `answer`: short statements with the numbers in them, `facts`: the same numbers as JSON, `sources`: which end…
get_precedents[measured] When did the market look like this before, and what did price do next? Scans our hourly archive for hours whose positioning resembled now (OI change 24h within 3 pp, funding APR within 15 points and same sign, long share within 5 pp, liquidation volume within x2.5), o…
test_rule[measured] Test a trigger against our hourly archive BEFORE acting on it or alerting on it: when was this rule true before, and what did price do next? Returns matched hours, independent episodes (one per 24 h) with each one's 24 h and 72 h return, the outcome statistics (share…
search_twitter[measured] Raw X (Twitter) search: one page of up to ~20 posts for any advanced-search query, each with text, time, author (username, followers, verified), likes, retweets, replies, quotes and views, plus next_cursor for the following page. Not limited to crypto. For a coin's se…
create_watch[alert] Buy a 30-day watch with ONE payment and no account, checked every 60 seconds: your own position within max_dist_pct of its liquidation price (type=position), a metric of a coin crossing a threshold (condition), a liquidation cascade ending (cascade), or a Hyperliquid wha…
get_watch[alert] The events of a watch bought with create_watch, newest first, with the watch's own parameters and expiry. Free. An empty list means the condition has not fired yet.
pretrade_check[measured + modeled] Call this BEFORE opening a leveraged perpetual position: one answer with the liquidation price on 12 venues, the liquidation levels between the price and it, how often price moved that far in our archive, derivatives fear & greed, Hyperliquid whale positioni…
get_x_user[measured] An X (Twitter) account by username: followers, following, bio, post count, verification, account age and pinned tweets. Any account, not only crypto. Always paid per call: $0.005 (x402, MPP or 1 prepaid credit); no key's daily allowance covers it.
get_x_user_tweets[measured] The latest posts of an X (Twitter) account, newest first, up to 20 a page with text, time, likes, retweets, replies, quotes and views, plus next_cursor. For a keyword search use search_twitter. Always paid per call: $0.005 (x402, MPP or 1 prepaid credit); no key's dai…
get_x_mentions[measured] Posts that mention an X (Twitter) account, newest first, up to 20 a page with author, followers and metrics, plus next_cursor. What people say TO or ABOUT an account. Always paid per call: $0.005 (x402, MPP or 1 prepaid credit); no key's daily allowance covers it.
get_x_tweet[measured] One X (Twitter) post by ID with its text, author and metrics, plus one page of up to 20 replies and next_cursor for more. Read a thread or the reaction to a post. Always paid per call: $0.005 (x402, MPP or 1 prepaid credit); no key's daily allowance covers it.
get_x_trends[measured] Trending topics on X (Twitter) right now for a location, with rank, name and the search query of each trend (pass it to search_twitter). Not limited to crypto. Always paid per call: $0.005 (x402, MPP or 1 prepaid credit); no key's daily allowance covers it.
get_crypto_twitter[measured + lexicon] Crypto Twitter pulse for one coin: the latest English posts on X with replies, retweets, spam and tiny accounts dropped; a bullish/bearish lean from -100 to +100 weighted by engagement and reach (a crypto word lexicon: rough, sarcasm fools it); posts per hou…
get_fear_greed[measured] Crypto fear & greed from DERIVATIVES positioning, 0 extreme fear .. 100 extreme greed: funding rate, long/short accounts, open interest change and 7-day momentum (each the percentile of its current value in the coin's own hourly archive) and the share of 24h liquidati…
get_hl_top_traders[measured] Top Hyperliquid traders worth following (copy trading): accounts in profit over the last week, month AND all time that traded this month, ranked by PnL (or sort=return), with PnL and volume per window and their open positions now. Then get_trader_profile on any addres…
get_trader_profile[measured] Is this Hyperliquid wallet a good trader? PnL and ROI by day, week, month and all time; win rate, profit factor, average win and loss and fees over its last 2,000 fills; favorite coins; leverage habits and how often it sat within 5% of liquidation (our hourly snapshot…
get_prediction_markets[measured] Polymarket crypto prediction markets for a coin: each market's probability, strike and its distance from the live price, 24h change, volume and liquidity; the market-implied median price of every 'above $X on <date>' ladder; and the coin's derivatives positioning now…
get_defi_liquidations[measured] DeFi lending liquidation map for Morpho Blue: borrowers nearest liquidation (health factor, the collateral price drop that liquidates them, debt), the debt that becomes liquidatable at a 1/2/5/10/15/20% drop per collateral asset, and pegged loops (stable/stable, ETH/L…
get_smart_money[measured] Smart money on Hyperliquid: how whale wallets are positioned and what they did. Per coin: whale accounts long vs short, notional and leverage per side, notional within 5% of its liquidation price, and the flow over the window (what the same wallets added and cut, in c…
scan_rule[measured] One rule tested on up to 100 coins in a single call: on which coins it was true in our hourly archive, what price did over the next 24 h and 72 h per coin (share up, median, worst, best) next to each coin's base rate, the POOLED outcome across coins with the number of…
check_position[measured + modeled] Your own position against the market in one call: the liquidation price on each venue from THAT venue's maintenance-margin tier at this notional (read from the exchanges' public tables, 'estimated' where none is published), the distance from the current mark…
attest_snapshot[receipt] A SIGNED snapshot: the wrapped endpoint's JSON plus an attestation (SHA-256 of the canonical JSON, server time, Ed25519 signature, key id). Anyone can verify it offline with the public key at /api/v1/attest/key, so an agent acting for someone else can prove what the ex…
buy_credits[payment] How an agent with a wallet buys a prepaid API key by itself, with ONE x402 USDC payment and no human, email or account. Returns the exact payment requirements (price, asset, payTo, network, the resource URL) for GET https://liquidvision.app/api/v1/credits/buy?usd=N. Se…
buy_day_pass[payment] A 24-hour Pro API key for ONE x402 USDC payment of $1.00 (Base or Arbitrum), no email or account: liquidation maps and heatmaps at full resolution, plus 400 units a day of metered calls (a row 1, a rule test 20, a rule scan 200). Returns the exact payment requirements…
credits_balance[account] Remaining prepaid credits on a key bought with buy_credits. Free/Pro/Bot keys are metered by daily quota instead (X-Raw-Quota-* headers) and return a note saying so.
explain_marketThe market brief behind a question such as 'Why did BTC drop 4%?': liquidations by window, funding extremes, open interest by venue, flows and risk zones for the coin, as one JSON for YOU to reason over. No language model runs on our side today, so `answer` is null and `brief` c…
get_footprint[measured] Footprint chart data: for each candle, taker BUY and taker SELL volume in USD and the trade count at each of 30 price levels, from the archived trade streams of Binance, Bybit, OKX, Bitget and Gate. Use it to see at which prices aggressive buyers or sellers were absor…
get_cvdCumulative volume delta split by trade size (retail <$10K, mid <$100K, large <$1M, whale >$1M). Whale-vs-retail divergence is the usual smart-money reading; buckets are per published row and only Binance aggregates taker orders, so compare buckets within one exchange (exchange=b…
get_spoofingOrder-book wall lifecycle heuristic: large levels classified as active_wall / absorbed / pulled_wall / suspected_spoof based on whether trades executed into them before they vanished.
get_api_keyGet 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: 120 req/min instea…
get_history[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…
create_alertSubscribe an HTTPS URL to push alerts instead of polling (Pro: 3, Bot: 20 subscriptions). type='condition': YOUR OWN trigger on one symbol — fires when `metric` `op` `threshold` becomes true (edge-triggered: once per crossing, again only after it was false). metric = funding_apr…
list_alertsThe webhook alert subscriptions that belong to the caller's API key (read-only): id, type, url, filters (symbol, min_usd, x_normal, max_dist_pct) and delivery health: last_status (HTTP code or error of the last delivery), fails (consecutive failures; a subscription pauses itself…
delete_alertPermanently 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 subscription owned by the caller's API key can be deleted; an id belonging to another…
get_hl_whales[measured] Leveraged positions of about 13,600 Hyperliquid accounts (the 10,000 largest plus every account seen trading) with the exchange-reported liquidation price, closest to liquidation first (sort='value' = largest first). Filters: coin (BTC), side (long|short), min_usd, ma…
get_detective_events[measured] Detective: what the watched large holders did. Private wallets with a large share of a token's supply (Ethereum, Solana) and Hyperliquid accounts with a large share of a contract's open interest are watched live. Event types: to_exchange (a watched wallet sent tokens…
get_lighter_liquidation_map[measured, RISK AHEAD, Lighter] REAL open positions on Lighter (zk perp DEX; crypto plus equity indices, stocks, forex, commodities) binned by Lighter's own liquidation price. Not a model. Use this for Lighter; get_hl_liquidation_map for Hyperliquid; get_liquidation_map (modeled…
get_lighter_whales[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. Snapsh…
get_hl_account[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…
get_tokenized_stocks[measured] Tokenized stocks, indices, ETFs, commodities, FX, rates and pre-IPO names traded as PERPS on DEXs (Lighter, Hyperliquid builder markets, Ostium and gTrade): one row per underlying (NVDA, TSLA, S&P 500, Gold, EUR/USD, Anthropic...) with every venue's mark, open interes…
get_hl_builder_markets[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 p…
get_hip3_markets[measured] The HIP-3 board: Hyperliquid's builder-deployed perp markets (equity indices, stocks, commodities, pre-IPO names; coins named dex:COIN such as xyz:SP500) with what the live list alone cannot tell you. Per dex: OI, share, 24h/7d OI change, 24h volume, liquidations. Per…
Headers
| Name | Description |
|---|---|
X-API-KeyOptional, secret | Optional. A free key: 120 requests a minute and 100 units a day of history and positions; Pro/Bot keys: 10,000 / 100,000 units a day, exports and alerts; prepaid keys spend credits. |
Details
| Endpoint | https://liquidvision.app/mcp (Streamable HTTP) |
| First published | 12 Nov 2026 |
| Last updated | 12 Nov 2026 |
| Registry name | app.liquidvision/derivatives |
More finance and crypto servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.