LiquidVision — Crypto Derivatives Data

Official29 tools

by liquidvision

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

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

Liquidation cascades as discrete events rather than a raw feed. Each event: coin, which side broke, when it started, how long it ran, total and peak-minute USD, how many multiples of that coin's own normal minute it was, the move in cross-venue median mark price during it, and what price did in the hour after. Also returns market_wide: minutes when three or more unrelated coins cascaded together.

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"
}

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

Open interest time series for a symbol (e.g. BTCUSDT) over the last `minutes` (5-10080).

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

Bucketed funding-rate history per exchange for a symbol (e.g. BTCUSDT) over the last `minutes` (5-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

Recent liquidation events (side, price, qty) across exchanges over the last `minutes` (1-1440). side=long means a long position was liquidated.

Parameters1

minutes

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "minutes": {
      "default": 60,
      "title": "Minutes",
      "type": "integer"
    }
  },
  "title": "get_liquidationsArguments"
}

get_liquidations_summary

Aggregated market-wide liquidation stats over the last `minutes`: 1h/4h/12h/24h totals split long/short, per-symbol and per-exchange breakdowns, and a 30-min time series.

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] Liquidation map for a perp symbol (e.g. BTCUSDT): estimated liquidation-cluster notional per price bin, split by leverage tier (10x/25x/50x/100x) and by exchange (binance/bybit/okx or 'all'), plus cumulative long/short curves from the current price outward. range: 12h | 1d | 3d | 7d. Validation vs realized liquidations: see 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] Liquidation map for Hyperliquid, not a model: leveraged positions of the ~3000 largest accounts binned by the exchange-reported liquidation price, long/short notional per bin, cumulative curves and the largest positions. Partial coverage: large accounts only. 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] Liquidation heatmap: estimated cluster intensity per price bin over time (grid[time][bin]) with the price path. 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

Order book liquidity heatmap grid (time x price buckets with resting quantity) for one exchange (binance/bybit/okx) and symbol (e.g. BTCUSDT).

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

Order-flow footprint for a core perp symbol: per candle x price bin, taker buy/sell USD volume and delta (Binance + Bybit trade streams).

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 = smart-money signal.

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"
}

Install

Tools (29)

list_marketsget_accuracyget_funding_ratesget_microstructureget_positioning_regimeget_liquidation_cascadesget_funding_dispersionget_funding_settlements

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

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

Install

Remote endpoint

Related servers