LiquidVision — Crypto Derivatives Data

Official42 tools

by lv-analytics · Python

Exchange-exact crypto derivatives data for AI agents: OI, funding, liquidations, 13 venues, 42 tools

The MCP server app.liquidvision/derivatives provides exchange-exact crypto derivatives data for AI agents, covering open interest (OI), funding, and liquidations across 13 venues. It is intended to expose these derivatives metrics in a form accessible to agent tooling.

🛠️ Key Features

Exchange-exact crypto derivatives data
Metrics include: OI, funding, liquidations
Coverage: 13 venues

🚀 Use Cases

Supplying AI agents with derivatives market state
Retrieving OI, funding, and liquidation information for analysis and decision support

⚡ Developer Benefits

Dataset is oriented toward AI agent consumption
Structured derivatives categories (OI, funding, liquidations) and venue coverage are explicitly defined

⚠️ Limitations

Limited to the listed derivatives data types (OI, funding, liquidations)
Venue scope is constrained to 13 venues

Captured live from the server via tools/list.

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "list_marketsArguments"
}

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 trusting any number here with money.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "get_accuracyArguments"
}

get_funding_rates

Latest perpetual funding rates and mark prices for every tracked exchange/symbol pair. Positive rate = longs pay shorts.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "get_funding_ratesArguments"
}

get_microstructure

Cross-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 apart venues price the same asset - plus a per-minute spread history. Does NOT answer "what moves price 0.5%": the streams only carry the innermost levels, so that would be extrapolation, not measurement.

Parameters1

minutes

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "minutes": {
      "default": 240,
      "title": "Minutes",
      "type": "integer"
    }
  },
  "title": "get_microstructureArguments"
}

get_positioning_regime

Per-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 net OI per regime) plus per coin the price change, OI change and current OI over the window.

Parameters1

minutes

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "minutes": {
      "default": 240,
      "title": "Minutes",
      "type": "integer"
    }
  },
  "title": "get_positioning_regimeArguments"
}

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 open positions at risk (*_liquidation_map). Each event: coin, which side broke, start, how long it ran, total and peak-minute USD, multiple of the coin's normal minute, the mark-price move during it and in the hour after. market_wide lists minutes when three or more unrelated coins cascaded together. hours: display window (baseline is always the last 7 days).

Parameters2

hours	integer	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "hours": {
      "default": 168,
      "title": "Hours",
      "type": "integer"
    },
    "limit": {
      "default": 40,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "get_liquidation_cascadesArguments"
}

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 entry has `url` (download with the API key in X-API-Key) and `available` for the caller's tier: Pro = this month and the previous one, Bot = all, free = none (use get_history for the last 24 h).

Parameters1

api_key

any

optional

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Key"
    }
  },
  "title": "list_history_packagesArguments"
}

get_funding_arbitrage

[measured] Funding carry screener on REALIZED numbers: for each coin, the venue pair a desk would put on (short where funding is richest, long where it is cheapest) and what that pair actually earned from funding over the last 7 and 30 days from our hourly archive, annualized; positive_share_7d = share of the week's hours the pair was net positive (0.5 is a coin flip); current_spread_apr = the same pair right now; mark_gap_bps = short-venue mark over long-venue mark (positive = entry in your favour). Use get_funding_dispersion for the live spread across all venues. Everything is gross: before taker fees, basis moves and two margin accounts. Not financial advice.

Parameters2

min_venues	integer	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "min_venues": {
      "default": 3,
      "title": "Min Venues",
      "type": "integer"
    },
    "limit": {
      "default": 40,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "get_funding_arbitrageArguments"
}

get_funding_dispersion

Coins 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 settlement cycle (1h / 4h / 8h), and the ranking uses the median rate over `window` minutes rather than the latest print, which is noisy for hourly contracts.

Parameters3

window	integer	optional
min_venues	integer	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "window": {
      "default": 60,
      "title": "Window",
      "type": "integer"
    },
    "min_venues": {
      "default": 6,
      "title": "Min Venues",
      "type": "integer"
    },
    "limit": {
      "default": 40,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "get_funding_dispersionArguments"
}

get_funding_settlements

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

Parameters3

symbol	string	required
days	integer	optional
exchange	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "title": "Symbol",
      "type": "string"
    },
    "days": {
      "default": 365,
      "title": "Days",
      "type": "integer"
    },
    "exchange": {
      "default": "all",
      "title": "Exchange",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "title": "get_funding_settlementsArguments"
}

get_open_interest

Latest open interest (contracts and USD) per exchange/symbol.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "get_open_interestArguments"
}

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 contract at once get_open_interest. symbol: BASEUSDT (BTCUSDT). minutes: look-back window, 5 to 20160 (14 days); snapped to a fixed set of windows.

Parameters2

symbol	string	required
minutes	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "title": "Symbol",
      "type": "string"
    },
    "minutes": {
      "default": 240,
      "title": "Minutes",
      "type": "integer"
    }
  },
  "required": [
    "symbol"
  ],
  "title": "get_open_interest_historyArguments"
}

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 LIVE predicted rate sampled over time; for the rates actually paid at each settlement (2 years back) use get_funding_settlements. symbol: BASEUSDT. minutes: 5 to 20160.

Parameters2

symbol	string	required
minutes	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "title": "Symbol",
      "type": "string"
    },
    "minutes": {
      "default": 1440,
      "title": "Minutes",
      "type": "integer"
    }
  },
  "required": [
    "symbol"
  ],
  "title": "get_funding_historyArguments"
}

get_long_short_ratio

Latest global long/short account ratio per exchange/symbol.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "get_long_short_ratioArguments"
}

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_liquidation_cascades; for where OPEN positions would be liquidated use a *_liquidation_map tool. Market-wide, 500 rows is only a few minutes of a busy hour: pass `symbol` (BTCUSDT) and/or `min_usd` to look further back. side=long means a long position was liquidated.

Parameters4

minutes	integer	optional
symbol	any	optional
min_usd	number	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "minutes": {
      "default": 60,
      "title": "Minutes",
      "type": "integer"
    },
    "symbol": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Symbol"
    },
    "min_usd": {
      "default": 0,
      "title": "Min Usd",
      "type": "number"
    },
    "limit": {
      "default": 500,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "get_liquidationsArguments"
}

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 individual orders (get_liquidations) or events (get_liquidation_cascades), and says nothing about open positions (the *_liquidation_map tools). Totals are a floor: Binance and Bitget throttle their feeds. side=long means longs were liquidated. minutes: 1 to 1440.

Parameters1

minutes

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "minutes": {
      "default": 1440,
      "title": "Minutes",
      "type": "integer"
    }
  },
  "title": "get_liquidations_summaryArguments"
}

get_oi_board

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

Parameters1

symbol

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "title": "Symbol",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "title": "get_oi_boardArguments"
}

get_cash_flows

Derivatives cash flow per exchange: net USD into/out of open interest over 1h/4h/24h windows, per core symbol. Positive = money flowing in.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "get_cash_flowsArguments"
}

get_arbitrum_perps

Arbitrum 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'.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "get_arbitrum_perpsArguments"
}

get_top_traders

Top lead traders (OKX copy trading, public data): total PnL, win rate, AUM, copiers, live open positions (pair, side, leverage, entry, uPnL) and recently closed trades with realized PnL.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "get_top_tradersArguments"
}

get_token_unlocks

Upcoming token unlock events for pool coins, nearest first: next unlock timestamp and token amount per public vesting schedule.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "get_token_unlocksArguments"
}

get_stocks

Crypto-related equities (COIN, MSTR, miners) and spot BTC/ETH ETF quotes: price, day change %, range, volume. ~15-min delayed.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "get_stocksArguments"
}

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_heatmap; for REAL positions use get_hl_liquidation_map (Hyperliquid) or get_lighter_liquidation_map (Lighter); for what already got liquidated use the PAST tools. Returns notional per bin split by leverage tier (5/10/20/25/50/100x) and by exchange, plus cumulative long/short curves from the current price outward. exchange: all | binance | bybit | okx. range: 12h | 1d | 3d | 7d. It ranks levels ("if price reaches this level, how much is there": top quarter of traded levels holds ~30-32% of liquidated USD, chance ~24%); it does NOT predict where price will go. Live scoring: get_accuracy.

Parameters3

symbol	string	required
exchange	string	optional
range	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "title": "Symbol",
      "type": "string"
    },
    "exchange": {
      "default": "all",
      "title": "Exchange",
      "type": "string"
    },
    "range": {
      "default": "1d",
      "title": "Range",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "title": "get_liquidation_mapArguments"
}

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 that traded since the reader started (~10,000 accounts, ~40-45% of venue open interest, stated in covered_long_pct/covered_short_pct). Not a model. Use this for Hyperliquid; use get_lighter_liquidation_map for Lighter and get_liquidation_map (modeled) for the CEXs. Returns long/short notional per bin, cumulative curves and the largest positions. range: 12h | 1d | 3d | 7d | max (±100%, recommended: large accounts run low leverage).

Parameters2

symbol	string	required
range	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "title": "Symbol",
      "type": "string"
    },
    "range": {
      "default": "1d",
      "title": "Range",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "title": "get_hl_liquidation_mapArguments"
}

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 to the traded range), price[t] the close. A level disappears once price trades through it. Call this only to see WHEN a cluster formed and whether it survived; for the current picture call get_liquidation_map (far smaller answer, split by leverage and exchange). The answer is large (about 35,000 numbers). symbol: BASEUSDT. exchange: all | binance | bybit | okx. range: 12h | 1d | 3d | 7d.

Parameters3

symbol	string	required
exchange	string	optional
range	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "title": "Symbol",
      "type": "string"
    },
    "exchange": {
      "default": "all",
      "title": "Exchange",
      "type": "string"
    },
    "range": {
      "default": "1d",
      "title": "Range",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "title": "get_liquidation_heatmapArguments"
}

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 they were pulled; not liquidations (see get_liquidation_heatmap for those) and not trades (get_footprint). exchange: binance | bybit | okx. symbol: BTCUSDT, ETHUSDT or SOLUSDT only. minutes: 1 to 1440.

Parameters3

exchange	string	required
symbol	string	required
minutes	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "exchange": {
      "title": "Exchange",
      "type": "string"
    },
    "symbol": {
      "title": "Symbol",
      "type": "string"
    },
    "minutes": {
      "default": 30,
      "title": "Minutes",
      "type": "integer"
    }
  },
  "required": [
    "exchange",
    "symbol"
  ],
  "title": "get_orderbook_heatmapArguments"
}

get_market_brief

Deterministic 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 involved — ideal input for your own reasoning.

Parameters1

symbol

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "default": "BTCUSDT",
      "title": "Symbol",
      "type": "string"
    }
  },
  "title": "get_market_briefArguments"
}

explain_market

AI risk-intelligence answer: ask e.g. 'Why did BTC drop 4%?' and get a concise grounded explanation (liquidation cascades, funding extremes, where the positions sit, next risk zone) computed from live derivatives data across 13 venues (CEXs, Hyperliquid and GMX).

Parameters2

question	string	required
symbol	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "question": {
      "title": "Question",
      "type": "string"
    },
    "symbol": {
      "default": "BTCUSDT",
      "title": "Symbol",
      "type": "string"
    }
  },
  "required": [
    "question"
  ],
  "title": "explain_marketArguments"
}

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 absorbed; for the net flow over time by trade 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.

Parameters3

symbol	string	optional
minutes	integer	optional
step	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "default": "BTCUSDT",
      "title": "Symbol",
      "type": "string"
    },
    "minutes": {
      "default": 240,
      "title": "Minutes",
      "type": "integer"
    },
    "step": {
      "default": 15,
      "title": "Step",
      "type": "integer"
    }
  },
  "title": "get_footprintArguments"
}

get_cvd

Cumulative 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=binance) rather than across venues.

Parameters2

symbol	string	optional
minutes	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "default": "BTCUSDT",
      "title": "Symbol",
      "type": "string"
    },
    "minutes": {
      "default": 240,
      "title": "Minutes",
      "type": "integer"
    }
  },
  "title": "get_cvdArguments"
}

get_spoofing

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

Parameters3

symbol	string	optional
exchange	string	optional
minutes	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "default": "BTCUSDT",
      "title": "Symbol",
      "type": "string"
    },
    "exchange": {
      "default": "binance",
      "title": "Exchange",
      "type": "string"
    },
    "minutes": {
      "default": 60,
      "title": "Minutes",
      "type": "integer"
    }
  },
  "title": "get_spoofingArguments"
}

get_api_key

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: 120 req/min instead of the shared anonymous budget, plus 100 metered calls a day (history, positions: get_funding_history, get_open_interest_history, get_funding_settlements, get_hl_whales, get_history...), and to upgrade later to Pro/Bot (unlimited, exports, webhook alerts). Ask the user for the email first; do not invent one.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "email": {
      "title": "Email",
      "type": "string"
    }
  },
  "required": [
    "email"
  ],
  "title": "get_api_keyArguments"
}

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

Parameters7

dataset	string	required
start	any	optional
end	any	optional
symbol	any	optional
exchange	any	optional
limit	integer	optional
api_key	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "dataset": {
      "title": "Dataset",
      "type": "string"
    },
    "start": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Start"
    },
    "end": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "End"
    },
    "symbol": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Symbol"
    },
    "exchange": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Exchange"
    },
    "limit": {
      "default": 500,
      "title": "Limit",
      "type": "integer"
    },
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Key"
    }
  },
  "required": [
    "dataset"
  ],
  "title": "get_historyArguments"
}

create_alert

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 = hex HMAC-SHA256(secret, raw body). Needs a Pro or Bot key.

Parameters7

type	string	required
url	string	required
symbol	any	optional
min_usd	number	optional
x_normal	number	optional
max_dist_pct	number	optional
api_key	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "title": "Type",
      "type": "string"
    },
    "url": {
      "title": "Url",
      "type": "string"
    },
    "symbol": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Symbol"
    },
    "min_usd": {
      "default": 1000000,
      "title": "Min Usd",
      "type": "number"
    },
    "x_normal": {
      "default": 8,
      "title": "X Normal",
      "type": "number"
    },
    "max_dist_pct": {
      "default": 3,
      "title": "Max Dist Pct",
      "type": "number"
    },
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Key"
    }
  },
  "required": [
    "type",
    "url"
  ],
  "title": "create_alertArguments"
}

list_alerts

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

Parameters1

api_key

any

optional

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Key"
    }
  },
  "title": "list_alertsArguments"
}

delete_alert

Permanently 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 key returns {"deleted": false} and changes nothing. id: the number returned by create_alert or list_alerts. Needs a Pro or Bot key (X-API-Key header of the MCP connection, or api_key).

Parameters2

id	integer	required
api_key	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "title": "Id",
      "type": "integer"
    },
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Key"
    }
  },
  "required": [
    "id"
  ],
  "title": "delete_alertArguments"
}

get_hl_whales

[measured] Leveraged positions of the 10,000 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.

Parameters6

coin	any	optional
side	any	optional
min_usd	number	optional
max_dist_pct	any	optional
sort	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "coin": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Coin"
    },
    "side": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Side"
    },
    "min_usd": {
      "default": 100000,
      "title": "Min Usd",
      "type": "number"
    },
    "max_dist_pct": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Max Dist Pct"
    },
    "sort": {
      "default": "distance",
      "title": "Sort",
      "type": "string"
    },
    "limit": {
      "default": 50,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "get_hl_whalesArguments"
}

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) for the CEXs. Accounts are discovered from the public trade stream, so coverage (covered_long_pct/covered_short_pct of venue open interest) grows with time. Returns long/short notional per bin, cumulative curves and the largest positions. range: 12h | 1d | 3d | 7d | max.

Parameters2

symbol	string	required
range	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "title": "Symbol",
      "type": "string"
    },
    "range": {
      "default": "1d",
      "title": "Range",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "title": "get_lighter_liquidation_mapArguments"
}

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. Snapshot age is in age_s.

Parameters6

coin	any	optional
side	any	optional
min_usd	number	optional
max_dist_pct	any	optional
sort	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "coin": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Coin"
    },
    "side": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Side"
    },
    "min_usd": {
      "default": 100000,
      "title": "Min Usd",
      "type": "number"
    },
    "max_dist_pct": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Max Dist Pct"
    },
    "sort": {
      "default": "distance",
      "title": "Sort",
      "type": "string"
    },
    "limit": {
      "default": 50,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "get_lighter_whalesArguments"
}

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 (key from the MCP connection's X-API-Key header, or api_key).

Parameters2

address	string	required
api_key	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "title": "Address",
      "type": "string"
    },
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Api Key"
    }
  },
  "required": [
    "address"
  ],
  "title": "get_hl_accountArguments"
}

get_tokenized_stocks

[measured] Tokenized stocks, indices, ETFs, commodities, FX, rates and pre-IPO names traded as PERPS on DEXs (Lighter and Hyperliquid builder markets): one row per underlying (NVDA, TSLA, S&P 500, Gold, EUR/USD, Anthropic...) with every venue's mark, open interest, 24 h volume, funding APR and the price gap between venues in bps. asset_class filters: equity | crypto_equity | etf | index | commodity | fx | rates | preipo. Use get_hl_builder_markets for the raw Hyperliquid HIP-3 list by dex.

Parameters1

asset_class

any

optional

Raw schema

{
  "type": "object",
  "properties": {
    "asset_class": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Asset Class"
    }
  },
  "title": "get_tokenized_stocksArguments"
}

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "get_hl_builder_marketsArguments"
}

README.md9 KBView on GitHub

LiquidVision.app — MCP server for crypto derivatives data

Crypto derivatives data for AI agents and trading bots: a remote MCP server, no install, no API key needed.

Endpoint: https://liquidvision.app/mcp (Streamable HTTP, 42 tools, read-only; the raw-row tools need a Pro/Bot key sent as X-API-Key, the conclusion tools do not) Lite endpoint: https://liquidvision.app/mcp/lite — the 13 tools that return conclusions (brief, explain, regime, cascades, dispersion, carry, microstructure, three liquidation maps, tokenized stocks, accuracy). Start here if your agent answers questions; use the full server for raw rows, history and alerts. Discovery: /.well-known/agent-card.json, /.well-known/mcp.json, /.well-known/x402.json; worked examples at /llms-full.txt.

Registry: server.json in this repo is the manifest for the Official MCP Registry (io.github.lv-analytics/liquidvision); also listed on Glama and in awesome-remote-mcp-servers.

What it gives an agent

Open interest and funding rates across 13 venues (Binance, MEXC, Bybit, Bitget, Hyperliquid, HTX, Gate, OKX, KuCoin, BingX, Aster, Kraken, GMX on Arbitrum), as each exchange reports them. An audit compares our figures with the exchanges' own endpoints every 10 minutes and publishes the result: https://liquidvision.app/accuracy (tool: get_accuracy).

Start with list_markets, then the computed views. They return a conclusion, not a pile of ticks:

Tool	Answers
`get_liquidation_cascades`	Liquidations grouped into events: start, duration, multiples of normal, what price did
`get_positioning_regime`	Price direction x change in positions per coin: new longs, short covering, new shorts, long flush
`get_funding_dispersion`	Coins ranked by how far funding disagrees across venues, each leg annualized with its real settlement cycle
`get_funding_arbitrage`	Realized funding carry per coin: what the short-richest / long-cheapest pair earned over 7 and 30 days, share of positive hours, mark gap now
`get_tokenized_stocks`	Tokenized stocks, indices, commodities, FX and pre-IPO names as perps on Lighter, Hyperliquid builder markets, Ostium and gTrade: OI, volume, funding, cross-venue price gap
`get_microstructure`	Cross-venue spread, top-of-book depth, basis
`get_market_brief`	One deterministic risk brief for a symbol: feed it to your own model
`explain_market`	"Why did BTC drop 4%?": a grounded answer built from the live data

Measured, not modeled (Hyperliquid and Lighter, where positions are public):

Tool	Returns
`get_hl_whales`	Leveraged positions of the 10,000 largest accounts with exchange-reported liquidation prices, closest to liquidation first
`get_hl_account`	One address: live positions, liquidation prices, archived snapshots
`get_hl_liquidation_map`	Those positions binned by liquidation price
`get_hl_builder_markets`	Builder-deployed (HIP-3) perp markets on Hyperliquid: equity indices, stocks, commodities, with open interest, volume, funding
`get_lighter_liquidation_map`	Measured liquidation map for Lighter: positions binned by the exchange-reported liquidation price, with the share of venue open interest covered
`get_lighter_whales`	Lighter positions with exchange-reported liquidation prices, closest to liquidation first (address = account index, l1_address = wallet)

Raw data: get_funding_rates, get_funding_history, get_funding_settlements, get_open_interest, get_open_interest_history, get_oi_board, get_cash_flows, get_long_short_ratio, get_liquidations, get_liquidations_summary, get_liquidation_map, get_liquidation_heatmap, get_orderbook_heatmap, get_footprint, get_cvd, get_spoofing, get_arbitrum_perps, get_top_traders, get_token_unlocks, get_stocks.

For bots: get_api_key (a free key by email, without a browser), get_history (archive rows as CSV for backtests), list_history_packages (monthly Parquet files per dataset with rows, bytes and sha256; Pro: this and last month, Bot: all), create_alert, list_alerts, delete_alert (webhooks: a liquidation cascade ended, a Hyperliquid whale is near liquidation, price reached a large modeled cluster).

Connect

Claude Code

bash

claude mcp add --transport http liquidvision https://liquidvision.app/mcp

Claude Desktop / claude.ai: Settings → Connectors → Add custom connector, URL https://liquidvision.app/mcp.

Cursor / Windsurf / any client with an mcp.json

json

{
  "mcpServers": {
    "liquidvision": {
      "url": "https://liquidvision.app/mcp"
    }
  }
}

Raw JSON-RPC

bash

curl -X POST https://liquidvision.app/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Claude Code skill

Copy skills/liquidvision into ~/.claude/skills/ (or a project's .claude/skills/). It tells the agent which tool answers which question, how to read measured vs modeled data, and how to pay per file with x402 when history is needed.

Without MCP

The same data is a REST API and a WebSocket feed (https://liquidvision.app/llms.txt lists every endpoint). Two small clients live in clients/: Python (standard library only; pip install "liquidvision[x402]" for pay-per-call) and JavaScript (built-in fetch; bring any EIP-712 signer for pay-per-call). Both start at brief().

python

from liquidvision import LiquidVision
lv = LiquidVision()
lv.brief("BTCUSDT")                                    # one coin, one JSON
lv.hl_whales(coin="BTC", max_dist_pct=5)["positions"]
lv.export("liquidations", symbol="BTCUSDT", start="2026-09-01", end="2026-09-08")
lv = LiquidVision(payer=X402Payer("0x..."))             # pay per file in USDC without an account
lv.package("liquidations", "2026-08", "liq_2026-08.parquet")

Examples

examples/passivbot_funding_filter.py: keeps Passivbot out of coins where holding the position is expensive (funding annualized with the contract's real interval) or where a liquidation cascade is running. Writes the ignored_coins file Passivbot reads continuously. Standard library only, no key: python examples/passivbot_funding_filter.py --exchange bybit --once
examples/binance_liq_probe.py: which Binance host actually delivers the liquidation stream.
collectors/gmx_v2.py: a standalone GMX v2 (Arbitrum) collector.

Limits and honesty

Free and anonymous: the conclusion tools and the lite server, 60 requests/min per IP (120 with a free key); raw-row tools need a Pro/Bot key or x402; send it as X-API-Key or Authorization: Bearer lv_.... Paid plans (history exports, webhook alerts, higher limits): https://liquidvision.app/pricing
explain_market costs real money to run: 5 answers/day anonymous, 25 with a free key.
Every dict answer carries age_s (seconds since the data was read from the exchange); rows of get_open_interest, get_funding_rates and get_long_short_ratio carry age_s each and stale: true when a venue feed is behind.
Open interest is counted on one side on every venue. Bybit documents its openInterest as "the sum of both sides" and we serve its singleOpenInterest; Gate and HTX report both sides and are halved. An aggregator showing those venues at twice our figure is showing both sides. Commands to check this yourself: docs/coinglass-vs-exchanges.md.
Liquidation events come from Binance, Bitget, OKX, Bybit, HTX, Gate, Kraken, GMX (on-chain, complete) and Hyperliquid whale accounts. Binance and Bitget throttle their feeds to one order per contract per second, so totals are a floor for the whole market.
The CEX liquidation map and heatmap are models built from candles and open-interest changes. They show where leveraged positions sit, not where price will go. Scored against realized liquidations (367 snapshots, 21 days): among the price levels actually traded in the next 24 h, the map's top quarter held 32% of the liquidated USD, against 25% by chance. The live score is on https://liquidvision.app/accuracy.
Symbols are BASEUSDT (BTCUSDT, ETHUSDT, ...). Computed views accept a fixed set of window sizes; other values snap to the nearest.

More for agents: https://liquidvision.app/llms.txt · REST/OpenAPI: https://liquidvision.app/api/v1/docs · status and uptime: https://liquidvision.app/status

Install

Tools (42)

list_marketsget_accuracyget_funding_ratesget_microstructureget_positioning_regimeget_liquidation_cascadeslist_history_packagesget_funding_arbitrage

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://liquidvision.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "derivatives": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://liquidvision.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

list_markets

get_accuracy

get_funding_rates

get_microstructure

get_positioning_regime

get_liquidation_cascades

list_history_packages

get_funding_arbitrage

get_funding_dispersion

get_funding_settlements

get_open_interest

get_open_interest_history

get_funding_history

get_long_short_ratio

get_liquidations

get_liquidations_summary

get_oi_board

get_cash_flows

get_arbitrum_perps

get_top_traders

get_token_unlocks

get_stocks

get_liquidation_map

get_hl_liquidation_map

get_liquidation_heatmap

get_orderbook_heatmap

get_market_brief

explain_market

get_footprint

get_cvd

get_spoofing

get_api_key

get_history

create_alert

list_alerts

delete_alert

get_hl_whales

get_lighter_liquidation_map

get_lighter_whales

get_hl_account

get_tokenized_stocks

get_hl_builder_markets

LiquidVision.app — MCP server for crypto derivatives data

What it gives an agent

Connect

Claude Code skill

Without MCP

Examples

Limits and honesty

Install

Remote endpoint

Related servers