LiquidVision — Crypto Derivatives Data is an MCP server published by app.liquidvision, hosted at liquidvision.app. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 69 tools, including list_markets, get_accuracy, get_funding_rates, get_microstructure, get_positioning_regime.
Crypto derivatives data and answers for AI agents: smart money, liquidations, funding, 13 venues
2 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
[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.
No parameters.
{
"name": "list_markets",
"title": "List markets and venues",
"description": "[measured] What exists: every venue we track and, for each, the contracts with live open\n interest right now (BASEUSDT symbols), plus the top-100 coin pool. Call this first when unsure\n which symbol or exchange string another tool accepts.",
"inputSchema": {
"type": "object",
"title": "list_marketsArguments",
"properties": {}
},
"annotations": {
"title": "List markets and venues",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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.
No parameters.
{
"name": "get_accuracy",
"title": "Our numbers vs the exchanges",
"description": "[measured] The public accuracy audit: our open interest and funding vs Binance, Bybit, OKX and\n Hyperliquid's own endpoints, sampled every 10 min (diff %, snapshot age, 24h mean/max), plus how\n the modeled liquidation map scored against realized liquidations. Read this before trusting\n any number here with money.",
"inputSchema": {
"type": "object",
"title": "get_accuracyArguments",
"properties": {}
},
"annotations": {
"title": "Our numbers vs the exchanges",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Latest perpetual funding rates and mark prices for every tracked exchange/symbol pair. Positive rate = longs pay shorts.
No parameters.
{
"name": "get_funding_rates",
"title": "Funding rates",
"description": "Latest perpetual funding rates and mark prices for every tracked\n exchange/symbol pair. Positive rate = longs pay shorts.",
"inputSchema": {
"type": "object",
"title": "get_funding_ratesArguments",
"properties": {}
},
"outputSchema": {
"type": "object",
"title": "get_funding_ratesOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Result"
}
}
},
"annotations": {
"title": "Funding rates",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| minutes | integer | Look-back window in minutes. |
{
"name": "get_microstructure",
"title": "Microstructure",
"description": "Cross-venue order book microstructure for BTC, ETH and SOL.\n\n Per venue: spread in bps, immediately-executable depth in USD and the bid\n share of it, measured over a band narrow enough that every venue's stream\n captured it, each venue around its own mid. Also the basis - how far apart\n venues price the same asset - plus a per-minute spread history.\n\n Does NOT answer \"what moves price 0.5%\": the streams only carry the\n innermost levels, so that would be extrapolation, not measurement.\n ",
"inputSchema": {
"type": "object",
"title": "get_microstructureArguments",
"properties": {
"minutes": {
"type": "integer",
"title": "Minutes",
"default": 240,
"description": "Look-back window in minutes."
}
}
},
"annotations": {
"title": "Microstructure",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| minutes | integer | Look-back window in minutes. |
{
"name": "get_positioning_regime",
"title": "Positioning regime",
"description": "Per-coin positioning regime from price direction crossed with open interest.\n\n price up + OI up = new longs; price up + OI down = short covering (a rally\n with no new buyers); price down + OI up = new shorts; price down + OI down =\n long flush. Returns a market summary (coins and net OI per regime) plus per\n coin the price change, OI change and current OI over the window.\n ",
"inputSchema": {
"type": "object",
"title": "get_positioning_regimeArguments",
"properties": {
"minutes": {
"type": "integer",
"title": "Minutes",
"default": 240,
"description": "Look-back window in minutes."
}
}
},
"annotations": {
"title": "Positioning regime",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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).
| Parameter | Type | Description |
|---|---|---|
| hours | integer | Look-back window in hours. |
| limit | integer | Maximum number of rows to return. |
{
"name": "get_liquidation_cascades",
"title": "Liquidation cascades",
"description": "[measured, PAST] Liquidation CASCADES as discrete events: bursts of liquidations detected\n against each coin's own 7-day normal minute. Use it for \"when did forced selling snowball and\n what did price do\"; not for totals (get_liquidations_summary), raw orders (get_liquidations)\n or open positions at risk (*_liquidation_map). Each event: coin, which side broke, start, how\n long it ran, total and peak-minute USD, multiple of the coin's normal minute, the mark-price\n move during it and in the hour after. market_wide lists minutes when three or more unrelated\n coins cascaded together. hours: display window (baseline is always the last 7 days).",
"inputSchema": {
"type": "object",
"title": "get_liquidation_cascadesArguments",
"properties": {
"hours": {
"type": "integer",
"title": "Hours",
"default": 168,
"description": "Look-back window in hours."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 40,
"description": "Maximum number of rows to return."
}
}
},
"annotations": {
"title": "Liquidation cascades",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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).
| Parameter | Type | Description |
|---|---|---|
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
{
"name": "list_history_packages",
"title": "List history packages",
"description": "[measured] Monthly Parquet history packages for backtests: liquidations (11 venues), funding hourly and\n settlements, open interest hourly, Hyperliquid and Lighter positions with liquidation prices — one file per\n dataset per month since 2026-07 with rows, bytes and sha256. Each entry has `url` (download with the API key\n in X-API-Key) and `available` for the caller's tier: Pro = this month and the previous one, Bot = all,\n free = none (use get_history for the last 24 h).",
"inputSchema": {
"type": "object",
"title": "list_history_packagesArguments",
"properties": {
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
}
}
},
"annotations": {
"title": "List history packages",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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 funding over the last 7 days (realized_7d_*, negative when the spread reversed) and 30 days, 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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum number of rows to return. |
| min_venues | integer | Only coins quoted on at least this many venues. |
{
"name": "get_funding_arbitrage",
"title": "Funding arbitrage",
"description": "[measured] Funding carry screener on REALIZED numbers, out of sample: for each coin, the venue\n pair a desk would have put on a week ago (short where funding WAS richest, long where it was\n cheapest, chosen on days 14-7 ago: selection_week_apr) and what that pair then earned from funding\n over the last 7 days (realized_7d_*, negative when the spread reversed) and 30 days, annualized;\n positive_share_7d = share of the week's hours the pair was net positive (0.5 is a coin flip);\n current_spread_apr = the same pair right now; mark_gap_bps = short-venue mark over long-venue\n mark (positive = entry in your favour). Use get_funding_dispersion for the live spread across\n all venues. Everything is gross: before taker fees, basis moves and two margin accounts.\n Not financial advice.",
"inputSchema": {
"type": "object",
"title": "get_funding_arbitrageArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 40,
"description": "Maximum number of rows to return."
},
"min_venues": {
"type": "integer",
"title": "Min Venues",
"default": 3,
"description": "Only coins quoted on at least this many venues."
}
}
},
"annotations": {
"title": "Funding arbitrage",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum number of rows to return. |
| window | integer | Aggregation window, as listed in the description. |
| min_venues | integer | Only coins quoted on at least this many venues. |
{
"name": "get_funding_dispersion",
"title": "Funding dispersion",
"description": "Coins ranked by how far funding disagrees ACROSS exchanges.\n\n For each coin: the spread in APR points between the venue charging the most\n and the one paying the most, plus which venue to hold the long on and which\n to hold the short on. Every leg is annualized with its own settlement cycle\n (1h / 4h / 8h), and the ranking uses the median rate over `window` minutes\n rather than the latest print, which is noisy for hourly contracts.\n ",
"inputSchema": {
"type": "object",
"title": "get_funding_dispersionArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 40,
"description": "Maximum number of rows to return."
},
"window": {
"type": "integer",
"title": "Window",
"default": 60,
"description": "Aggregation window, as listed in the description."
},
"min_venues": {
"type": "integer",
"title": "Min Venues",
"default": 6,
"description": "Only coins quoted on at least this many venues."
}
}
},
"annotations": {
"title": "Funding dispersion",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Look-back window in days. |
| symbol * | string | Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT). |
| exchange | string | Venue id (binance, bybit, okx, bitget, hyperliquid, gate, htx, kucoin, mexc, bingx, aster, kraken, gmx) or 'all' where the tool allows it. |
{
"name": "get_funding_settlements",
"title": "Funding settlements",
"description": "Settled funding rates, one row per settlement, from Binance and Bybit\n history — up to 730 days for any pool coin (e.g. BTCUSDT). The backtest\n series; get_funding_history is the live 10-second archive since July 2026.",
"inputSchema": {
"type": "object",
"title": "get_funding_settlementsArguments",
"required": [
"symbol"
],
"properties": {
"days": {
"type": "integer",
"title": "Days",
"default": 365,
"description": "Look-back window in days."
},
"symbol": {
"type": "string",
"title": "Symbol",
"description": "Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT)."
},
"exchange": {
"type": "string",
"title": "Exchange",
"default": "all",
"description": "Venue id (binance, bybit, okx, bitget, hyperliquid, gate, htx, kucoin, mexc, bingx, aster, kraken, gmx) or 'all' where the tool allows it."
}
}
},
"annotations": {
"title": "Funding settlements",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Latest open interest (contracts and USD) per exchange/symbol.
No parameters.
{
"name": "get_open_interest",
"title": "Open interest",
"description": "Latest open interest (contracts and USD) per exchange/symbol.",
"inputSchema": {
"type": "object",
"title": "get_open_interestArguments",
"properties": {}
},
"outputSchema": {
"type": "object",
"title": "get_open_interestOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Result"
}
}
},
"annotations": {
"title": "Open interest",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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.
| Parameter | Type | Description |
|---|---|---|
| symbol * | string | Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT). |
| minutes | integer | Look-back window in minutes. |
{
"name": "get_open_interest_history",
"title": "Open interest history",
"description": "[measured] Open interest over time for one contract, one row per venue per time\n bucket: ts (ms), exchange, oi (coins, one side), oi_usd. Use it to see how positioning\n built up or unwound; for the current snapshot with shares and 1h/4h/24h changes use\n get_oi_board, for every contract at once get_open_interest. symbol: BASEUSDT (BTCUSDT).\n minutes: look-back window, 5 to 20160 (14 days); snapped to a fixed set of windows.",
"inputSchema": {
"type": "object",
"title": "get_open_interest_historyArguments",
"required": [
"symbol"
],
"properties": {
"symbol": {
"type": "string",
"title": "Symbol",
"description": "Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT)."
},
"minutes": {
"type": "integer",
"title": "Minutes",
"default": 240,
"description": "Look-back window in minutes."
}
}
},
"outputSchema": {
"type": "object",
"title": "get_open_interest_historyOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Result"
}
}
},
"annotations": {
"title": "Open interest history",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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.
| Parameter | Type | Description |
|---|---|---|
| symbol * | string | Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT). |
| minutes | integer | Look-back window in minutes. |
{
"name": "get_funding_history",
"title": "Funding history",
"description": "[measured] Funding rate over time for one contract, one row per venue per time bucket:\n ts (ms), exchange, funding_rate (per settlement interval, a fraction), mark_price and\n funding_hours (that contract's interval: 1, 4 or 8). Annualize as rate * 8760 / funding_hours.\n This is the LIVE predicted rate sampled over time; for the rates actually paid at each\n settlement (2 years back) use get_funding_settlements. symbol: BASEUSDT. minutes: 5 to 20160.",
"inputSchema": {
"type": "object",
"title": "get_funding_historyArguments",
"required": [
"symbol"
],
"properties": {
"symbol": {
"type": "string",
"title": "Symbol",
"description": "Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT)."
},
"minutes": {
"type": "integer",
"title": "Minutes",
"default": 1440,
"description": "Look-back window in minutes."
}
}
},
"outputSchema": {
"type": "object",
"title": "get_funding_historyOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Result"
}
}
},
"annotations": {
"title": "Funding history",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Latest global long/short account ratio per exchange/symbol.
No parameters.
{
"name": "get_long_short_ratio",
"title": "Long short ratio",
"description": "Latest global long/short account ratio per exchange/symbol.",
"inputSchema": {
"type": "object",
"title": "get_long_short_ratioArguments",
"properties": {}
},
"outputSchema": {
"type": "object",
"title": "get_long_short_ratioOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Result"
}
}
},
"annotations": {
"title": "Long short ratio",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum number of rows to return. |
| symbol | any | Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT). |
| min_usd | number | Only rows at or above this notional in USD. |
| minutes | integer | Look-back window in minutes. |
{
"name": "get_liquidations",
"title": "Liquidations",
"description": "[measured, PAST] Individual liquidation ORDERS that already happened (side, price, qty),\n newest first, at most `limit` rows (max 2000). This is the raw feed: use it when you need the\n orders themselves. For totals use get_liquidations_summary; for cascades as events use\n get_liquidation_cascades; for where OPEN positions would be liquidated use a *_liquidation_map\n tool. Market-wide, 500 rows is only a few minutes of a busy hour: pass `symbol` (BTCUSDT)\n and/or `min_usd` to look further back. side=long means a long position was liquidated.",
"inputSchema": {
"type": "object",
"title": "get_liquidationsArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 500,
"description": "Maximum number of rows to return."
},
"symbol": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Symbol",
"default": null,
"description": "Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT)."
},
"min_usd": {
"type": "number",
"title": "Min Usd",
"default": 0,
"description": "Only rows at or above this notional in USD."
},
"minutes": {
"type": "integer",
"title": "Minutes",
"default": 60,
"description": "Look-back window in minutes."
}
}
},
"outputSchema": {
"type": "object",
"title": "get_liquidationsOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Result"
}
}
},
"annotations": {
"title": "Liquidations",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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.
| Parameter | Type | Description |
|---|---|---|
| minutes | integer | Look-back window in minutes. |
{
"name": "get_liquidations_summary",
"title": "Liquidations summary",
"description": "[measured, PAST] TOTALS of liquidations that already happened: rekt (USD liquidated in the\n last 1h/4h/12h/24h, split long/short), by_symbol and by_exchange over the last `minutes`, and\n series (30-minute buckets). The one to call for \"how much was liquidated\"; it does not return\n individual orders (get_liquidations) or events (get_liquidation_cascades), and says nothing\n about open positions (the *_liquidation_map tools). Totals are a floor: Binance and Bitget\n throttle their feeds. side=long means longs were liquidated. minutes: 1 to 1440.",
"inputSchema": {
"type": "object",
"title": "get_liquidations_summaryArguments",
"properties": {
"minutes": {
"type": "integer",
"title": "Minutes",
"default": 1440,
"description": "Look-back window in minutes."
}
}
},
"annotations": {
"title": "Liquidations summary",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| symbol * | string | Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT). |
{
"name": "get_oi_board",
"title": "Open interest board",
"description": "Per-venue open-interest ranking for a perp symbol (e.g. BTCUSDT): OI in\n coins and USD, market share %, 1h/4h/24h OI change % and USD flow, and\n OI / 24h-volume ratio per exchange, plus market totals.",
"inputSchema": {
"type": "object",
"title": "get_oi_boardArguments",
"required": [
"symbol"
],
"properties": {
"symbol": {
"type": "string",
"title": "Symbol",
"description": "Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT)."
}
}
},
"annotations": {
"title": "Open interest board",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Derivatives cash flow per exchange: net USD into/out of open interest over 1h/4h/24h windows, per core symbol. Positive = money flowing in.
No parameters.
{
"name": "get_cash_flows",
"title": "Cash flows",
"description": "Derivatives cash flow per exchange: net USD into/out of open interest\n over 1h/4h/24h windows, per core symbol. Positive = money flowing in.",
"inputSchema": {
"type": "object",
"title": "get_cash_flowsArguments",
"properties": {}
},
"annotations": {
"title": "Cash flows",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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'.
No parameters.
{
"name": "get_arbitrum_perps",
"title": "Arbitrum perps board",
"description": "Arbitrum perps board: GMX v2 open interest per coin and its share of every\n tracked venue, GMX funding next to the CEX median (8h basis), on-chain\n liquidations over 24h. Ask this for 'how is Arbitrum positioned vs CEXs'.",
"inputSchema": {
"type": "object",
"title": "get_arbitrum_perpsArguments",
"properties": {}
},
"annotations": {
"title": "Arbitrum perps board",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Top 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 with a profile per address, use get_hl_top_traders and get_trader_profile (priced).
No parameters.
{
"name": "get_top_traders",
"title": "Top traders",
"description": "Top traders on OKX copy trading, Hyperliquid and GMX (public data, free): total PnL, win rate,\n AUM, copiers, live open positions (pair, side, leverage, entry, uPnL) and recently closed\n trades with realized PnL. For a ranked list of consistently profitable Hyperliquid wallets\n with a profile per address, use get_hl_top_traders and get_trader_profile (priced).",
"inputSchema": {
"type": "object",
"title": "get_top_tradersArguments",
"properties": {}
},
"annotations": {
"title": "Top traders",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Upcoming token unlock events for pool coins, nearest first: next unlock timestamp and token amount per public vesting schedule.
No parameters.
{
"name": "get_token_unlocks",
"title": "Token unlocks",
"description": "Upcoming token unlock events for pool coins, nearest first: next unlock\n timestamp and token amount per public vesting schedule.",
"inputSchema": {
"type": "object",
"title": "get_token_unlocksArguments",
"properties": {}
},
"annotations": {
"title": "Token unlocks",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Crypto-related equities (COIN, MSTR, miners) and spot BTC/ETH ETF quotes: price, day change %, range, volume. ~15-min delayed.
No parameters.
{
"name": "get_stocks",
"title": "Stocks",
"description": "Crypto-related equities (COIN, MSTR, miners) and spot BTC/ETH ETF quotes:\n price, day change %, range, volume. ~15-min delayed.",
"inputSchema": {
"type": "object",
"title": "get_stocksArguments",
"properties": {}
},
"annotations": {
"title": "Stocks",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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": the top quarter of traded levels held 32% of liquidated USD against 25% by chance, 367 snapshots); it does NOT predict where price will go. Live scoring: get_accuracy. PRICE: the full map is a metered call ($0.005, or a key). Without a key this tool returns the free summary: USD on each side of the price and the largest level on each side.
| Parameter | Type | Description |
|---|---|---|
| range | string | Price range around the current price: 12h | 1d | 3d | 7d (and 'max' where stated), the traded range of that window. |
| symbol * | string | Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT). |
| exchange | string | Venue id (binance, bybit, okx, bitget, hyperliquid, gate, htx, kucoin, mexc, bingx, aster, kraken, gmx) or 'all' where the tool allows it. |
{
"name": "get_liquidation_map",
"title": "Liquidation map (modeled)",
"description": "[modeled, RISK AHEAD, CEX, now] ESTIMATED open leveraged positions on Binance/Bybit/OKX per\n price bin at their liquidation price, from candles and open-interest deltas (the CEXs do not\n publish positions). Current snapshot only; for its evolution over time use\n get_liquidation_heatmap; for REAL positions use get_hl_liquidation_map (Hyperliquid) or\n get_lighter_liquidation_map (Lighter); for what already got liquidated use the PAST tools.\n Returns notional per bin split by leverage tier (5/10/20/25/50/100x) and by exchange, plus\n cumulative long/short curves from the current price outward. exchange: all | binance | bybit |\n okx. range: 12h | 1d | 3d | 7d. It ranks levels (\"if price reaches this level, how much is\n there\": the top quarter of traded levels held 32% of liquidated USD against 25% by chance, 367 snapshots); it does NOT\n predict where price will go. Live scoring: get_accuracy.\n PRICE: the full map is a metered call ($0.005, or a key). Without a key this tool returns the\n free summary: USD on each side of the price and the largest level on each side.",
"inputSchema": {
"type": "object",
"title": "get_liquidation_mapArguments",
"required": [
"symbol"
],
"properties": {
"range": {
"type": "string",
"title": "Range",
"default": "1d",
"description": "Price range around the current price: 12h | 1d | 3d | 7d (and 'max' where stated), the traded range of that window."
},
"symbol": {
"type": "string",
"title": "Symbol",
"description": "Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT)."
},
"exchange": {
"type": "string",
"title": "Exchange",
"default": "all",
"description": "Venue id (binance, bybit, okx, bitget, hyperliquid, gate, htx, kucoin, mexc, bingx, aster, kraken, gmx) or 'all' where the tool allows it."
}
}
},
"annotations": {
"title": "Liquidation map (modeled)",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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 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). PRICE: the full map is a metered call ($0.005, or a key). Without a key this tool returns the free summary: USD on each side of the price and the largest level on each side.
| Parameter | Type | Description |
|---|---|---|
| range | string | Price range around the current price: 12h | 1d | 3d | 7d (and 'max' where stated), the traded range of that window. |
| symbol * | string | Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT). |
{
"name": "get_hl_liquidation_map",
"title": "Hyperliquid liquidation map (measured)",
"description": "[measured, RISK AHEAD, Hyperliquid] REAL open positions on Hyperliquid binned by the\n liquidation price the exchange itself reports: the 10,000 largest accounts plus every account\n seen trading since the reader started (about 13,600 accounts, ~40-45% of venue open interest, stated\n in covered_long_pct/covered_short_pct). Not a model. Use this for Hyperliquid; use\n get_lighter_liquidation_map for Lighter and get_liquidation_map (modeled) for the CEXs.\n Returns long/short notional per bin, cumulative curves and the largest positions. range: 12h\n | 1d | 3d | 7d | max (±100%, recommended: large accounts run low leverage).\n PRICE: the full map is a metered call ($0.005, or a key). Without a key this tool returns the\n free summary: USD on each side of the price and the largest level on each side.",
"inputSchema": {
"type": "object",
"title": "get_hl_liquidation_mapArguments",
"required": [
"symbol"
],
"properties": {
"range": {
"type": "string",
"title": "Range",
"default": "1d",
"description": "Price range around the current price: 12h | 1d | 3d | 7d (and 'max' where stated), the traded range of that window."
},
"symbol": {
"type": "string",
"title": "Symbol",
"description": "Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT)."
}
}
},
"annotations": {
"title": "Hyperliquid liquidation map (measured)",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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. PRICE: the full map is a metered call ($0.005, or a key). Without a key this tool returns the free summary: USD on each side of the price and the largest level on each side.
| Parameter | Type | Description |
|---|---|---|
| range | string | Price range around the current price: 12h | 1d | 3d | 7d (and 'max' where stated), the traded range of that window. |
| symbol * | string | Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT). |
| exchange | string | Venue id (binance, bybit, okx, bitget, hyperliquid, gate, htx, kucoin, mexc, bingx, aster, kraken, gmx) or 'all' where the tool allows it. |
{
"name": "get_liquidation_heatmap",
"title": "Liquidation heatmap",
"description": "[modeled, RISK AHEAD, CEX, over time] The same estimated CEX map as get_liquidation_map but\n as a time series: grid[t][b] is the estimated USD of leveraged positions with their\n liquidation price in price bin b at time cols[t] (ms), bins[b] the bin's centre price (240\n bins fitted to the traded range), price[t] the close. A level disappears once price trades\n through it. Call this only to see WHEN a cluster formed and whether it survived; for the\n current picture call get_liquidation_map (far smaller answer, split by leverage and exchange).\n The answer is large (about 35,000 numbers). symbol: BASEUSDT. exchange: all | binance | bybit\n | okx. range: 12h | 1d | 3d | 7d.\n PRICE: the full map is a metered call ($0.005, or a key). Without a key this tool returns the\n free summary: USD on each side of the price and the largest level on each side.",
"inputSchema": {
"type": "object",
"title": "get_liquidation_heatmapArguments",
"required": [
"symbol"
],
"properties": {
"range": {
"type": "string",
"title": "Range",
"default": "1d",
"description": "Price range around the current price: 12h | 1d | 3d | 7d (and 'max' where stated), the traded range of that window."
},
"symbol": {
"type": "string",
"title": "Symbol",
"description": "Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT)."
},
"exchange": {
"type": "string",
"title": "Exchange",
"default": "all",
"description": "Venue id (binance, bybit, okx, bitget, hyperliquid, gate, htx, kucoin, mexc, bingx, aster, kraken, gmx) or 'all' where the tool allows it."
}
}
},
"annotations": {
"title": "Liquidation heatmap",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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.
| Parameter | Type | Description |
|---|---|---|
| symbol * | string | Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT). |
| minutes | integer | Look-back window in minutes. |
| exchange * | string | Venue id (binance, bybit, okx, bitget, hyperliquid, gate, htx, kucoin, mexc, bingx, aster, kraken, gmx) or 'all' where the tool allows it. |
{
"name": "get_orderbook_heatmap",
"title": "Orderbook heatmap",
"description": "[measured] Resting limit orders over time on ONE exchange: cells of (time bucket, price\n bucket, quantity in coins) from archived order-book snapshots, with price_min, price_max,\n price_step and time_step (seconds) describing the grid. Shows where bid and ask walls\n stood and when they were pulled; not liquidations (see get_liquidation_heatmap for\n those) and not trades (get_footprint). exchange: binance | bybit | okx. symbol: BTCUSDT,\n ETHUSDT or SOLUSDT only. minutes: 1 to 1440.",
"inputSchema": {
"type": "object",
"title": "get_orderbook_heatmapArguments",
"required": [
"exchange",
"symbol"
],
"properties": {
"symbol": {
"type": "string",
"title": "Symbol",
"description": "Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT)."
},
"minutes": {
"type": "integer",
"title": "Minutes",
"default": 30,
"description": "Look-back window in minutes."
},
"exchange": {
"type": "string",
"title": "Exchange",
"description": "Venue id (binance, bybit, okx, bitget, hyperliquid, gate, htx, kucoin, mexc, bingx, aster, kraken, gmx) or 'all' where the tool allows it."
}
}
},
"annotations": {
"title": "Orderbook heatmap",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| symbol | string | Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT). |
{
"name": "get_market_brief",
"title": "Market brief for a coin",
"description": "Deterministic market brief for a perp symbol: 24h liquidations (totals,\n by exchange), current funding + 24h extremes per venue, OI by venue with\n 1h/4h/24h changes, net position flows, modeled liquidation risk zones\n above/below price, and top-trader positioning. Free, no LLM involved —\n ideal input for your own reasoning.",
"inputSchema": {
"type": "object",
"title": "get_market_briefArguments",
"properties": {
"symbol": {
"type": "string",
"title": "Symbol",
"default": "BTCUSDT",
"description": "Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT)."
}
}
},
"annotations": {
"title": "Market brief for a coin",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}ONE 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 endpoints were read and how old their data is, `caveats`. The question is read for its topics (liquidations, funding, open interest, whales, levels, sentiment; English or Russian) and only those endpoints are fetched. No model involved: facts, not opinion, so you do the judging. Free, no key. For the base rate of the current state call get_precedents; for the full brief of a coin call get_market_brief.
| Parameter | Type | Description |
|---|---|---|
| coin | string | Base asset, e.g. BTC, ETH, SOL (no USDT suffix). |
| question * | string | The question in plain words, English or Russian. |
{
"name": "ask",
"title": "Ask a derivatives question",
"description": "ONE CALL instead of five: ask in plain words ('where is leverage stacked on BTC',\n 'why did ETH drop', 'is SOL funding crowded', 'biggest whales near liquidation') and get\n `answer`: short statements with the numbers in them, `facts`: the same numbers as JSON,\n `sources`: which endpoints were read and how old their data is, `caveats`. The question is\n read for its topics (liquidations, funding, open interest, whales, levels, sentiment;\n English or Russian) and only those endpoints are fetched. No model involved: facts, not\n opinion, so you do the judging. Free, no key. For the base rate of the current state\n call get_precedents; for the full brief of a coin call get_market_brief.",
"inputSchema": {
"type": "object",
"title": "askArguments",
"required": [
"question"
],
"properties": {
"coin": {
"type": "string",
"title": "Coin",
"default": "BTC",
"description": "Base asset, e.g. BTC, ETH, SOL (no USDT suffix)."
},
"question": {
"type": "string",
"title": "Question",
"description": "The question in plain words, English or Russian."
}
}
},
"annotations": {
"title": "Ask a derivatives question",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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), one per day, and returns the 24h and 72h price outcome of those look-alikes: count, share that went up, median and quartiles, worst and best, next to the unconditional base rate over the same archive. `verdict` says whether the sample is big enough to mean anything. Frequencies from our hourly archive (since 2026-07-18), NOT a forecast. Priced: $0.05 per call (x402), 10 prepaid credits, 10 of a free key's 100 daily units, or Pro/Bot.
| Parameter | Type | Description |
|---|---|---|
| coin | string | Base asset, e.g. BTC, ETH, SOL (no USDT suffix). |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
{
"name": "get_precedents",
"title": "Past hours that resembled now",
"description": "[measured] When did the market look like this before, and what did price do next?\n Scans our hourly archive for hours whose positioning resembled now (OI change 24h within\n 3 pp, funding APR within 15 points and same sign, long share within 5 pp, liquidation\n volume within x2.5), one per day, and returns the 24h and 72h price outcome of those\n look-alikes: count, share that went up, median and quartiles, worst and best, next to the\n unconditional base rate over the same archive. `verdict` says whether the sample is big\n enough to mean anything. Frequencies from our hourly archive (since 2026-07-18), NOT a forecast.\n Priced: $0.05 per call (x402), 10 prepaid credits, 10 of a free key's 100 daily units, or Pro/Bot.",
"inputSchema": {
"type": "object",
"title": "get_precedentsArguments",
"properties": {
"coin": {
"type": "string",
"title": "Coin",
"default": "BTC",
"description": "Base asset, e.g. BTC, ETH, SOL (no USDT suffix)."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
}
}
},
"annotations": {
"title": "Past hours that resembled now",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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 up, median, quartiles, worst, best), the unconditional base rate over the same hours, whether the rule is true right now, and a `verdict` on sample size. The rule syntax is the condition-alert syntax, so a rule that tests well becomes create_alert(type= 'condition', ...) with the same metric/op/threshold. Frequencies from our archive (hourly, since 2026-07 for BTC/ETH/SOL), NOT a forecast. Priced: $0.10 per call (x402), 20 prepaid credits, a free key's daily quota (20 of its 100 units), or Pro/Bot.
| Parameter | Type | Description |
|---|---|---|
| coin | string | Base asset, e.g. BTC, ETH, SOL (no USDT suffix). |
| rules * | string | Up to 3 rules joined by commas or 'and', each metric>threshold or metric<threshold. Metrics: price_chg_1h_pct, price_chg_24h_pct, oi_chg_1h_pct, oi_chg_24h_pct, funding_apr_pct, long_pct, liq_1h_usd, liq_24h_usd. Example: funding_apr_pct>8,oi_chg_24h_pct>2 |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
{
"name": "test_rule",
"title": "Test a trading rule on the archive",
"description": "[measured] Test a trigger against our hourly archive BEFORE acting on it or alerting on\n it: when was this rule true before, and what did price do next? Returns matched hours,\n independent episodes (one per 24 h) with each one's 24 h and 72 h return, the outcome\n statistics (share up, median, quartiles, worst, best), the unconditional base rate over the\n same hours, whether the rule is true right now, and a `verdict` on sample size. The rule\n syntax is the condition-alert syntax, so a rule that tests well becomes create_alert(type=\n 'condition', ...) with the same metric/op/threshold. Frequencies from our archive (hourly,\n since 2026-07 for BTC/ETH/SOL), NOT a forecast. Priced: $0.10 per call (x402), 20 prepaid credits, a free\n key's daily quota (20 of its 100 units), or Pro/Bot.",
"inputSchema": {
"type": "object",
"title": "test_ruleArguments",
"required": [
"rules"
],
"properties": {
"coin": {
"type": "string",
"title": "Coin",
"default": "BTC",
"description": "Base asset, e.g. BTC, ETH, SOL (no USDT suffix)."
},
"rules": {
"type": "string",
"title": "Rules",
"description": "Up to 3 rules joined by commas or 'and', each metric>threshold or metric<threshold. Metrics: price_chg_1h_pct, price_chg_24h_pct, oi_chg_1h_pct, oi_chg_24h_pct, funding_apr_pct, long_pct, liq_1h_usd, liq_24h_usd. Example: funding_apr_pct>8,oi_chg_24h_pct>2"
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
}
}
},
"annotations": {
"title": "Test a trading rule on the archive",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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 sentiment next to its positioning use get_crypto_twitter instead. Always paid per call: $0.005 a page (x402, MPP or 1 prepaid credit); no key's daily allowance covers it, Pro and Bot included.
| Parameter | Type | Description |
|---|---|---|
| type | string | Latest (newest first) or Top. |
| query * | string | X advanced-search query: keywords, $cashtags, #hashtags, from:user, since:YYYY-MM-DD, lang:en, min_faves:50, -filter:replies ... |
| cursor | string | next_cursor of the previous page; empty for the first page. |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
{
"name": "search_twitter",
"title": "Search X (Twitter)",
"description": "[measured] Raw X (Twitter) search: one page of up to ~20 posts for any advanced-search query,\n each with text, time, author (username, followers, verified), likes, retweets, replies, quotes\n and views, plus next_cursor for the following page. Not limited to crypto. For a coin's\n sentiment next to its positioning use get_crypto_twitter instead. Always paid per call: $0.005 a page\n (x402, MPP or 1 prepaid credit); no key's daily allowance covers it, Pro and Bot included.",
"inputSchema": {
"type": "object",
"title": "search_twitterArguments",
"required": [
"query"
],
"properties": {
"type": {
"type": "string",
"title": "Type",
"default": "Latest",
"description": "Latest (newest first) or Top."
},
"query": {
"type": "string",
"title": "Query",
"description": "X advanced-search query: keywords, $cashtags, #hashtags, from:user, since:YYYY-MM-DD, lang:en, min_faves:50, -filter:replies ..."
},
"cursor": {
"type": "string",
"title": "Cursor",
"default": "",
"description": "next_cursor of the previous page; empty for the first page."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
}
}
},
"annotations": {
"title": "Search X (Twitter)",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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 whale near liquidation (hl_near_liq). Returns watch_id; read its events with get_watch (free). Priced: $0.20 (x402, MPP), 40 prepaid credits, or a key's daily units.
| Parameter | Type | Description |
|---|---|---|
| op | any | condition: gt or lt. |
| url | any | Optional HTTPS URL that also receives each event. |
| side | any | position: long or short. |
| type * | string | position | condition | cascade | hl_near_liq |
| entry | any | position: entry price. |
| venue | any | position: one venue id (optional). |
| metric | any | condition: funding_apr_pct | oi_chg_1h_pct | oi_chg_24h_pct | liq_1h_usd | liq_24h_usd | price_chg_1h_pct | price_chg_24h_pct | long_pct |
| symbol | any | Coin or contract, e.g. BTC. Required except for cascade. |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
[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.
| Parameter | Type | Description |
|---|---|---|
| since | integer | Only events sent after this time in ms; 0 for all. |
| watch_id * | string | The watch_id returned by create_watch (w_...). |
{
"name": "get_watch",
"title": "Watch",
"description": "[alert] The events of a watch bought with create_watch, newest first, with the watch's own\n parameters and expiry. Free. An empty list means the condition has not fired yet.",
"inputSchema": {
"type": "object",
"title": "get_watchArguments",
"required": [
"watch_id"
],
"properties": {
"since": {
"type": "integer",
"title": "Since",
"default": 0,
"description": "Only events sent after this time in ms; 0 for all."
},
"watch_id": {
"type": "string",
"title": "Watch Id",
"description": "The watch_id returned by create_watch (w_...)."
}
}
},
"annotations": {
"title": "Watch",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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 positioning with its 24 h flow, funding cost per day, and `flags`: the measured facts that go against the trade. Replaces check_position + the map summaries + get_fear_greed + get_smart_money. Not a signal. Priced: $0.05 (x402, MPP), 10 prepaid credits, or a key's daily units.
| Parameter | Type | Description |
|---|---|---|
| side * | string | long or short. |
| entry | any | Entry price; omit to use the current mark. |
| symbol * | string | Base asset or contract, e.g. BTC or BTCUSDT. |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
| leverage * | number | Leverage of the position, e.g. 20. |
| notional_usd | number | Position size in USD (margin x leverage). |
{
"name": "pretrade_check",
"title": "Pretrade check",
"description": "[measured + modeled] Call this BEFORE opening a leveraged perpetual position: one answer with\n the liquidation price on 12 venues, the liquidation levels between the price and it, how often\n price moved that far in our archive, derivatives fear & greed, Hyperliquid whale positioning with\n its 24 h flow, funding cost per day, and `flags`: the measured facts that go against the trade.\n Replaces check_position + the map summaries + get_fear_greed + get_smart_money. Not a signal.\n Priced: $0.05 (x402, MPP), 10 prepaid credits, or a key's daily units.",
"inputSchema": {
"type": "object",
"title": "pretrade_checkArguments",
"required": [
"symbol",
"side",
"leverage"
],
"properties": {
"side": {
"type": "string",
"title": "Side",
"description": "long or short."
},
"entry": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Entry",
"default": null,
"description": "Entry price; omit to use the current mark."
},
"symbol": {
"type": "string",
"title": "Symbol",
"description": "Base asset or contract, e.g. BTC or BTCUSDT."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
},
"leverage": {
"type": "number",
"title": "Leverage",
"description": "Leverage of the position, e.g. 20."
},
"notional_usd": {
"type": "number",
"title": "Notional Usd",
"default": 10000,
"description": "Position size in USD (margin x leverage)."
}
}
},
"annotations": {
"title": "Pretrade check",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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.
| Parameter | Type | Description |
|---|---|---|
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
| username * | string | X handle without @, e.g. HyperliquidX. |
{
"name": "get_x_user",
"title": "X user",
"description": "[measured] An X (Twitter) account by username: followers, following, bio, post count, verification,\n account age and pinned tweets. Any account, not only crypto.\n Always paid per call: $0.005 (x402, MPP or 1 prepaid credit); no key's daily allowance covers it.",
"inputSchema": {
"type": "object",
"title": "get_x_userArguments",
"required": [
"username"
],
"properties": {
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
},
"username": {
"type": "string",
"title": "Username",
"description": "X handle without @, e.g. HyperliquidX."
}
}
},
"annotations": {
"title": "X user",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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 daily allowance covers it.
| Parameter | Type | Description |
|---|---|---|
| cursor | string | next_cursor of the previous page; empty for the first page. |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
| username * | string | X handle without @, e.g. HyperliquidX. |
{
"name": "get_x_user_tweets",
"title": "X user tweets",
"description": "[measured] The latest posts of an X (Twitter) account, newest first, up to 20 a page with text, time,\n likes, retweets, replies, quotes and views, plus next_cursor. For a keyword search use search_twitter.\n Always paid per call: $0.005 (x402, MPP or 1 prepaid credit); no key's daily allowance covers it.",
"inputSchema": {
"type": "object",
"title": "get_x_user_tweetsArguments",
"required": [
"username"
],
"properties": {
"cursor": {
"type": "string",
"title": "Cursor",
"default": "",
"description": "next_cursor of the previous page; empty for the first page."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
},
"username": {
"type": "string",
"title": "Username",
"description": "X handle without @, e.g. HyperliquidX."
}
}
},
"annotations": {
"title": "X user tweets",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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.
| Parameter | Type | Description |
|---|---|---|
| cursor | string | next_cursor of the previous page; empty for the first page. |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
| username * | string | X handle without @, e.g. HyperliquidX. |
{
"name": "get_x_mentions",
"title": "X mentions",
"description": "[measured] Posts that mention an X (Twitter) account, newest first, up to 20 a page with author,\n followers and metrics, plus next_cursor. What people say TO or ABOUT an account.\n Always paid per call: $0.005 (x402, MPP or 1 prepaid credit); no key's daily allowance covers it.",
"inputSchema": {
"type": "object",
"title": "get_x_mentionsArguments",
"required": [
"username"
],
"properties": {
"cursor": {
"type": "string",
"title": "Cursor",
"default": "",
"description": "next_cursor of the previous page; empty for the first page."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
},
"username": {
"type": "string",
"title": "Username",
"description": "X handle without @, e.g. HyperliquidX."
}
}
},
"annotations": {
"title": "X mentions",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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.
| Parameter | Type | Description |
|---|---|---|
| cursor | string | next_cursor of the previous page; empty for the first page. |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
| tweet_id * | string | Numeric ID of the post (the digits at the end of its URL). |
{
"name": "get_x_tweet",
"title": "X tweet",
"description": "[measured] One X (Twitter) post by ID with its text, author and metrics, plus one page of up to 20\n replies and next_cursor for more. Read a thread or the reaction to a post.\n Always paid per call: $0.005 (x402, MPP or 1 prepaid credit); no key's daily allowance covers it.",
"inputSchema": {
"type": "object",
"title": "get_x_tweetArguments",
"required": [
"tweet_id"
],
"properties": {
"cursor": {
"type": "string",
"title": "Cursor",
"default": "",
"description": "next_cursor of the previous page; empty for the first page."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
},
"tweet_id": {
"type": "string",
"title": "Tweet Id",
"description": "Numeric ID of the post (the digits at the end of its URL)."
}
}
},
"annotations": {
"title": "X tweet",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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.
| Parameter | Type | Description |
|---|---|---|
| count | integer | How many trends, 5 to 50. |
| woeid | integer | Location: 1 = worldwide, or a country/city WOEID (23424977 = United States). |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
{
"name": "get_x_trends",
"title": "X trends",
"description": "[measured] Trending topics on X (Twitter) right now for a location, with rank, name and the search\n query of each trend (pass it to search_twitter). Not limited to crypto.\n Always paid per call: $0.005 (x402, MPP or 1 prepaid credit); no key's daily allowance covers it.",
"inputSchema": {
"type": "object",
"title": "get_x_trendsArguments",
"properties": {
"count": {
"type": "integer",
"title": "Count",
"default": 30,
"description": "How many trends, 5 to 50."
},
"woeid": {
"type": "integer",
"title": "Woeid",
"default": 1,
"description": "Location: 1 = worldwide, or a country/city WOEID (23424977 = United States)."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
}
}
},
"annotations": {
"title": "X trends",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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 hour; the top posts with author and link; and next to them the coin's funding rate, open interest change and long/short positioning, with one sentence on whether talk and positioning agree. Cached 10 minutes. Always paid per call: $0.02 (x402, MPP or 4 prepaid credits); no key's daily allowance covers it, Pro and Bot included.
| Parameter | Type | Description |
|---|---|---|
| coin * | string | Base asset, e.g. BTC, SOL, HYPE (no USDT suffix). |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
{
"name": "get_crypto_twitter",
"title": "Crypto Twitter pulse",
"description": "[measured + lexicon] Crypto Twitter pulse for one coin: the latest English posts on X with\n replies, retweets, spam and tiny accounts dropped; a bullish/bearish lean from -100 to +100\n weighted by engagement and reach (a crypto word lexicon: rough, sarcasm fools it); posts per\n hour; the top posts with author and link; and next to them the coin's funding rate, open\n interest change and long/short positioning, with one sentence on whether talk and\n positioning agree. Cached 10 minutes. Always paid per call: $0.02 (x402, MPP or 4\n prepaid credits); no key's daily allowance covers it, Pro and Bot included.",
"inputSchema": {
"type": "object",
"title": "get_crypto_twitterArguments",
"required": [
"coin"
],
"properties": {
"coin": {
"type": "string",
"title": "Coin",
"description": "Base asset, e.g. BTC, SOL, HYPE (no USDT suffix)."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
}
}
},
"annotations": {
"title": "Crypto Twitter pulse",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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 liquidations that hit shorts. Not news, not social media. Priced: $0.005 per call (x402), 1 credit, or a key's quota.
| Parameter | Type | Description |
|---|---|---|
| coin | string | BTC, ETH, SOL ... or 'market' (the mean of BTC, ETH and SOL). |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
{
"name": "get_fear_greed",
"title": "Derivatives fear & greed",
"description": "[measured] Crypto fear & greed from DERIVATIVES positioning, 0 extreme fear .. 100 extreme greed:\n funding rate, long/short accounts, open interest change and 7-day momentum (each the percentile\n of its current value in the coin's own hourly archive) and the share of 24h liquidations that hit\n shorts. Not news, not social media. Priced: $0.005 per call (x402), 1 credit, or a key's quota.",
"inputSchema": {
"type": "object",
"title": "get_fear_greedArguments",
"properties": {
"coin": {
"type": "string",
"title": "Coin",
"default": "market",
"description": "BTC, ETH, SOL ... or 'market' (the mean of BTC, ETH and SOL)."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
}
}
},
"annotations": {
"title": "Derivatives fear & greed",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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 address. Priced: $0.03 per call (x402), 6 credits, or a key's quota.
| Parameter | Type | Description |
|---|---|---|
| sort | string | pnl (USD profit, default) or return (profit over account value). |
| limit | integer | How many traders, 1-100. |
| window | string | Rank by this window's PnL: day, week, month or allTime. |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
| min_account_usd | number | Minimum account value, USD. |
{
"name": "get_hl_top_traders",
"title": "Top Hyperliquid traders",
"description": "[measured] Top Hyperliquid traders worth following (copy trading): accounts in profit over the\n last week, month AND all time that traded this month, ranked by PnL (or sort=return), with PnL and volume per window\n and their open positions now. Then get_trader_profile on any address. Priced: $0.03 per call\n (x402), 6 credits, or a key's quota.",
"inputSchema": {
"type": "object",
"title": "get_hl_top_tradersArguments",
"properties": {
"sort": {
"type": "string",
"title": "Sort",
"default": "pnl",
"description": "pnl (USD profit, default) or return (profit over account value)."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 25,
"description": "How many traders, 1-100."
},
"window": {
"type": "string",
"title": "Window",
"default": "month",
"description": "Rank by this window's PnL: day, week, month or allTime."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
},
"min_account_usd": {
"type": "number",
"title": "Min Account Usd",
"default": 100000,
"description": "Minimum account value, USD."
}
}
},
"annotations": {
"title": "Top Hyperliquid traders",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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 snapshots); open positions now. Priced: $0.02 per call (x402), 4 credits, or a key's quota.
| Parameter | Type | Description |
|---|---|---|
| address * | string | Hyperliquid wallet, 0x + 40 hex characters. |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
{
"name": "get_trader_profile",
"title": "Hyperliquid trader profile",
"description": "[measured] Is this Hyperliquid wallet a good trader? PnL and ROI by day, week, month and all time;\n win rate, profit factor, average win and loss and fees over its last 2,000 fills; favorite coins;\n leverage habits and how often it sat within 5% of liquidation (our hourly snapshots); open\n positions now. Priced: $0.02 per call (x402), 4 credits, or a key's quota.",
"inputSchema": {
"type": "object",
"title": "get_trader_profileArguments",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"title": "Address",
"description": "Hyperliquid wallet, 0x + 40 hex characters."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
}
}
},
"annotations": {
"title": "Hyperliquid trader profile",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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 (funding, long share, OI change). Priced: $0.02 per call (x402), 4 credits, or a key's quota.
| Parameter | Type | Description |
|---|---|---|
| coin | any | BTC, ETH, SOL ...; all crypto markets when omitted. |
| limit | integer | How many events, 1-50. |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
{
"name": "get_prediction_markets",
"title": "Polymarket crypto odds",
"description": "[measured] Polymarket crypto prediction markets for a coin: each market's probability, strike and\n its distance from the live price, 24h change, volume and liquidity; the market-implied median price\n of every 'above $X on <date>' ladder; and the coin's derivatives positioning now (funding, long\n share, OI change). Priced: $0.02 per call (x402), 4 credits, or a key's quota.",
"inputSchema": {
"type": "object",
"title": "get_prediction_marketsArguments",
"properties": {
"coin": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Coin",
"default": null,
"description": "BTC, ETH, SOL ...; all crypto markets when omitted."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 10,
"description": "How many events, 1-50."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
}
}
},
"annotations": {
"title": "Polymarket crypto odds",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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/LST) apart. Priced: $0.02 per call (x402), 4 credits, or a key's quota.
| Parameter | Type | Description |
|---|---|---|
| chain | string | base, ethereum or arbitrum. |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
| collateral | any | Only this collateral, e.g. cbBTC, WETH, wstETH. |
{
"name": "get_defi_liquidations",
"title": "DeFi liquidation map (Morpho)",
"description": "[measured] DeFi lending liquidation map for Morpho Blue: borrowers nearest liquidation (health\n factor, the collateral price drop that liquidates them, debt), the debt that becomes liquidatable\n at a 1/2/5/10/15/20% drop per collateral asset, and pegged loops (stable/stable, ETH/LST) apart.\n Priced: $0.02 per call (x402), 4 credits, or a key's quota.",
"inputSchema": {
"type": "object",
"title": "get_defi_liquidationsArguments",
"properties": {
"chain": {
"type": "string",
"title": "Chain",
"default": "base",
"description": "base, ethereum or arbitrum."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
},
"collateral": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Collateral",
"default": null,
"description": "Only this collateral, e.g. cbBTC, WETH, wstETH."
}
}
},
"annotations": {
"title": "DeFi liquidation map (Morpho)",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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 coins valued at today's mark, so a price move is not counted as buying), plus the largest wallet moves with addresses. From hourly snapshots of about 13,600 accounts with exchange-reported liquidation prices. Large is not the same as right: positioning, not a signal. Look up any address from top_movers with get_hl_account. Priced: $0.03 per call (x402), 6 prepaid credits, or a key's quota.
| Parameter | Type | Description |
|---|---|---|
| coin | any | One coin, e.g. BTC, ETH, HYPE; all coins when omitted. |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
| window_h | integer | Flow window in hours: 4, 24 or 72. |
| min_account_usd | number | A whale holds at least this much open notional, USD. |
{
"name": "get_smart_money",
"title": "Smart money on Hyperliquid",
"description": "[measured] Smart money on Hyperliquid: how whale wallets are positioned and what they did.\n Per coin: whale accounts long vs short, notional and leverage per side, notional within 5% of\n its liquidation price, and the flow over the window (what the same wallets added and cut,\n in coins valued at today's mark, so a price move is not counted as buying), plus the largest\n wallet moves with addresses. From hourly snapshots of about 13,600 accounts with exchange-reported\n liquidation prices. Large is not the same as right: positioning, not a signal. Look up any\n address from top_movers with get_hl_account. Priced: $0.03 per call (x402), 6 prepaid\n credits, or a key's quota.",
"inputSchema": {
"type": "object",
"title": "get_smart_moneyArguments",
"properties": {
"coin": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Coin",
"default": null,
"description": "One coin, e.g. BTC, ETH, HYPE; all coins when omitted."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
},
"window_h": {
"type": "integer",
"title": "Window H",
"default": 24,
"description": "Flow window in hours: 4, 24 or 72."
},
"min_account_usd": {
"type": "number",
"title": "Min Account Usd",
"default": 1000000,
"description": "A whale holds at least this much open notional, USD."
}
}
},
"annotations": {
"title": "Smart money on Hyperliquid",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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 distinct days behind it (coins move together, so days, not episodes, are the sample), and `true_now`: the coins the rule is true on right now. Use it to find where a setup has occurred and where it is live, instead of calling test_rule per coin. Frequencies from our archive, NOT a forecast; the note explains why the best of many scans is not an edge. Priced: $1.00 per call (x402, USDC on Base or Arbitrum), 200 prepaid credits (one $1 pack), or a Pro/Bot key. Takes 10-40 s on a cold cache.
| Parameter | Type | Description |
|---|---|---|
| coins | integer | How many coins to scan, the largest by open interest first (5-100). |
| rules * | string | Up to 3 rules joined by commas or 'and', each metric>threshold or metric<threshold. Metrics: price_chg_1h_pct, price_chg_24h_pct, oi_chg_1h_pct, oi_chg_24h_pct, funding_apr_pct, long_pct, liq_1h_usd, liq_24h_usd. Example: funding_apr_pct>8,oi_chg_24h_pct>2 |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
{
"name": "scan_rule",
"title": "Scan a rule across coins",
"description": "[measured] One rule tested on up to 100 coins in a single call: on which coins it was true in\n our hourly archive, what price did over the next 24 h and 72 h per coin (share up, median,\n worst, best) next to each coin's base rate, the POOLED outcome across coins with the number\n of distinct days behind it (coins move together, so days, not episodes, are the sample), and\n `true_now`: the coins the rule is true on right now. Use it to find where a setup has\n occurred and where it is live, instead of calling test_rule per coin. Frequencies from our\n archive, NOT a forecast; the note explains why the best of many scans is not an edge.\n Priced: $1.00 per call (x402, USDC on Base or Arbitrum), 200 prepaid credits (one $1 pack),\n or a Pro/Bot key. Takes 10-40 s on a cold cache.",
"inputSchema": {
"type": "object",
"title": "scan_ruleArguments",
"required": [
"rules"
],
"properties": {
"coins": {
"type": "integer",
"title": "Coins",
"default": 30,
"description": "How many coins to scan, the largest by open interest first (5-100)."
},
"rules": {
"type": "string",
"title": "Rules",
"description": "Up to 3 rules joined by commas or 'and', each metric>threshold or metric<threshold. Metrics: price_chg_1h_pct, price_chg_24h_pct, oi_chg_1h_pct, oi_chg_24h_pct, funding_apr_pct, long_pct, liq_1h_usd, liq_24h_usd. Example: funding_apr_pct>8,oi_chg_24h_pct>2"
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
}
}
},
"annotations": {
"title": "Scan a rule across coins",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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, how much modeled CEX leverage and how much MEASURED Hyperliquid leverage sits between the mark and your liquidation price on your side, the funding cost per day at the venue's live rate, and how often in our hourly archive price moved at least that far against your side within 24 h and 72 h (a frequency, not a forecast). Assumes isolated margin and ignores fees, so the real level is slightly nearer the entry. ONE venue (venue= given) is free; the 12-venue comparison is an answer we price: $0.02 per call (x402), 4 prepaid credits, or a key's daily quota.
| Parameter | Type | Description |
|---|---|---|
| coin | string | Base asset, e.g. BTC, ETH, SOL (no USDT suffix). |
| side * | string | Position side: long | short. |
| entry * | number | Entry price in quote currency (USDT). |
| venue | any | Venue id (binance, bybit, okx, bitget, gate, kucoin, kraken, hyperliquid, htx, mexc, bingx, aster). Omit for every venue side by side. |
| leverage * | number | Leverage, e.g. 10 for 10x (isolated margin assumed). |
| notional_usd | number | Position size in USD (price x quantity). |
[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 exchanges reported when it decided. Free snapshots and conclusions only (no metered history). It certifies what LiquidVision served, not that the exchange was right. Priced: $0.05 per call (x402), 10 prepaid credits, or a key's daily quota; the public key at /attest/key is free.
| Parameter | Type | Description |
|---|---|---|
| path * | string | API path under /api/v1 to wrap, e.g. /funding, /oi, /liquidations, /oiboard/BTCUSDT, /liqmap/BTCUSDT, /answer, /position/check. |
| params | any | Query string for the wrapped path, e.g. 'q=why+did+BTC+drop&coin=BTC' or 'symbol=BTC&side=long&leverage=20'. |
{
"name": "attest_snapshot",
"title": "Signed data snapshot",
"description": "[receipt] A SIGNED snapshot: the wrapped endpoint's JSON plus an attestation (SHA-256 of the\n canonical JSON, server time, Ed25519 signature, key id). Anyone can verify it offline with\n the public key at /api/v1/attest/key, so an agent acting for someone else can prove what the\n exchanges reported when it decided. Free snapshots and conclusions only (no metered history).\n It certifies what LiquidVision served, not that the exchange was right. Priced: $0.05 per call (x402),\n 10 prepaid credits, or a key's daily quota; the public key at /attest/key is free.",
"inputSchema": {
"type": "object",
"title": "attest_snapshotArguments",
"required": [
"path"
],
"properties": {
"path": {
"type": "string",
"title": "Path",
"description": "API path under /api/v1 to wrap, e.g. /funding, /oi, /liquidations, /oiboard/BTCUSDT, /liqmap/BTCUSDT, /answer, /position/check."
},
"params": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Params",
"default": null,
"description": "Query string for the wrapped path, e.g. 'q=why+did+BTC+drop&coin=BTC' or 'symbol=BTC&side=long&leverage=20'."
}
}
},
"annotations": {
"title": "Signed data snapshot",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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. Send that GET with a PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1) header from your wallet and the answer is a key of tier 'prepaid' with the credits ($0.005 each; a row costs 1, a 12-venue position check 4, precedents or an attestation 10, a rule test 20); the same wallet always tops up the same key. Credits are spent per call by price class; every conclusion and live snapshot stays free. This tool itself moves no money.
| Parameter | Type | Description |
|---|---|---|
| usd | integer | Pack size in USD: 1 (200 credits), 5 (1,000) or 20 (4,000). |
{
"name": "buy_credits",
"title": "Buy prepaid credits",
"description": "[payment] How an agent with a wallet buys a prepaid API key by itself, with ONE x402 USDC\n payment and no human, email or account. Returns the exact payment requirements (price, asset,\n payTo, network, the resource URL) for GET https://liquidvision.app/api/v1/credits/buy?usd=N.\n Send that GET with a PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1) header from your wallet and the\n answer is a key of tier 'prepaid' with the credits ($0.005 each; a row costs 1, a 12-venue position check 4, precedents or an attestation 10, a rule test 20); the same wallet always tops up the same key.\n Credits are spent per call by price class; every\n conclusion and live snapshot stays free. This tool itself moves no money.",
"inputSchema": {
"type": "object",
"title": "buy_creditsArguments",
"properties": {
"usd": {
"type": "integer",
"title": "Usd",
"default": 5,
"description": "Pack size in USD: 1 (200 credits), 5 (1,000) or 20 (4,000)."
}
}
},
"annotations": {
"title": "Buy prepaid credits",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[payment] A 24-hour 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 for GET https://liquidvision.app/api/v1/pass/day; send that GET with a PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1) header and the answer carries api_key and its expiry. The same wallet extends the same key. This tool itself moves no money.
No parameters.
{
"name": "buy_day_pass",
"title": "Buy a 24-hour key",
"description": "[payment] A 24-hour API key for ONE x402 USDC payment of $1.00 (Base or Arbitrum), no email\n or account: liquidation maps and heatmaps at full resolution, plus 400 units\n a day of metered calls (a row 1, a rule test 20, a rule scan 200). Returns the exact payment requirements for\n GET https://liquidvision.app/api/v1/pass/day; send that GET with a PAYMENT-SIGNATURE (v2) or\n X-PAYMENT (v1) header and the answer carries api_key and its expiry. The same wallet extends the\n same key. This tool itself moves no money.",
"inputSchema": {
"type": "object",
"title": "buy_day_passArguments",
"properties": {}
},
"annotations": {
"title": "Buy a 24-hour key",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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.
| Parameter | Type | Description |
|---|---|---|
| api_key | any | The prepaid key (lv_...). Omit when it is sent as X-API-Key on the connection. |
{
"name": "credits_balance",
"title": "Prepaid credit balance",
"description": "[account] Remaining prepaid credits on a key bought with buy_credits. Free/Pro/Bot keys are\n metered by daily quota instead (X-Raw-Quota-* headers) and return a note saying so.",
"inputSchema": {
"type": "object",
"title": "credits_balanceArguments",
"properties": {
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "The prepaid key (lv_...). Omit when it is sent as X-API-Key on the connection."
}
}
},
"annotations": {
"title": "Prepaid credit balance",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}The 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` carries the facts (if a model is configured later, `answer` holds its short narrative). For a ready plain-words answer with no model, call ask.
| Parameter | Type | Description |
|---|---|---|
| symbol | string | Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT). |
| question * | string | The question in plain words, English or Russian. |
{
"name": "explain_market",
"title": "Market brief for a question",
"description": "The market brief behind a question such as 'Why did BTC drop 4%?': liquidations by\n window, funding extremes, open interest by venue, flows and risk zones for the coin, as one\n JSON for YOU to reason over. No language model runs on our side today, so `answer` is null and\n `brief` carries the facts (if a model is configured later, `answer` holds its short narrative).\n For a ready plain-words answer with no model, call ask.",
"inputSchema": {
"type": "object",
"title": "explain_marketArguments",
"required": [
"question"
],
"properties": {
"symbol": {
"type": "string",
"title": "Symbol",
"default": "BTCUSDT",
"description": "Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT)."
},
"question": {
"type": "string",
"title": "Question",
"description": "The question in plain words, English or Russian."
}
}
},
"annotations": {
"title": "Market brief for a question",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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.
| Parameter | Type | Description |
|---|---|---|
| step | integer | Candle size in minutes, 1 to 240. |
| symbol | string | Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT). |
| minutes | integer | Look-back window in minutes. |
{
"name": "get_footprint",
"title": "Footprint",
"description": "[measured] Footprint chart data: for each candle, taker BUY and taker SELL volume in\n USD and the trade count at each of 30 price levels, from the archived trade streams of\n Binance, Bybit, OKX, Bitget and Gate. Use it to see at which prices aggressive buyers\n or sellers were absorbed; for the net flow over time by trade size use get_cvd. symbol:\n BTCUSDT, ETHUSDT or SOLUSDT only. minutes: look-back window, 15 to 10080. step: candle\n size in minutes, 1 to 240.",
"inputSchema": {
"type": "object",
"title": "get_footprintArguments",
"properties": {
"step": {
"type": "integer",
"title": "Step",
"default": 15,
"description": "Candle size in minutes, 1 to 240."
},
"symbol": {
"type": "string",
"title": "Symbol",
"default": "BTCUSDT",
"description": "Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT)."
},
"minutes": {
"type": "integer",
"title": "Minutes",
"default": 240,
"description": "Look-back window in minutes."
}
}
},
"annotations": {
"title": "Footprint",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| symbol | string | Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT). |
| minutes | integer | Look-back window in minutes. |
{
"name": "get_cvd",
"title": "Cumulative volume delta",
"description": "Cumulative volume delta split by trade size (retail <$10K, mid <$100K,\n large <$1M, whale >$1M). Whale-vs-retail divergence is the usual smart-money reading; buckets\n are per published row and only Binance aggregates taker orders, so compare buckets within one\n exchange (exchange=binance) rather than across venues.",
"inputSchema": {
"type": "object",
"title": "get_cvdArguments",
"properties": {
"symbol": {
"type": "string",
"title": "Symbol",
"default": "BTCUSDT",
"description": "Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT)."
},
"minutes": {
"type": "integer",
"title": "Minutes",
"default": 240,
"description": "Look-back window in minutes."
}
}
},
"annotations": {
"title": "Cumulative volume delta",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| symbol | string | Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT). |
| minutes | integer | Look-back window in minutes. |
| exchange | string | Venue id (binance, bybit, okx, bitget, hyperliquid, gate, htx, kucoin, mexc, bingx, aster, kraken, gmx) or 'all' where the tool allows it. |
{
"name": "get_spoofing",
"title": "Spoofing",
"description": "Order-book wall lifecycle heuristic: large levels classified as\n active_wall / absorbed / pulled_wall / suspected_spoof based on whether\n trades executed into them before they vanished.",
"inputSchema": {
"type": "object",
"title": "get_spoofingArguments",
"properties": {
"symbol": {
"type": "string",
"title": "Symbol",
"default": "BTCUSDT",
"description": "Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT)."
},
"minutes": {
"type": "integer",
"title": "Minutes",
"default": 60,
"description": "Look-back window in minutes."
},
"exchange": {
"type": "string",
"title": "Exchange",
"default": "binance",
"description": "Venue id (binance, bybit, okx, bitget, hyperliquid, gate, htx, kucoin, mexc, bingx, aster, kraken, gmx) or 'all' where the tool allows it."
}
}
},
"annotations": {
"title": "Spoofing",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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 units a day of metered calls (history, positions: get_funding_history, get_open_interest_history, get_funding_settlements, get_hl_whales, get_history...), and to upgrade later to Pro/Bot (10,000 / 100,000 metered calls a day, exports, webhook alerts). Ask the user for the email first; do not invent one.
| Parameter | Type | Description |
|---|---|---|
| email * | string | The owner's email address; the key is issued to it once. |
{
"name": "get_api_key",
"title": "Get a free API key",
"description": "Get a free LiquidVision API key for this agent's owner, by email, without a browser.\n Works for a NEW email only (an existing account's key is never returned; its owner sees it\n at liquidvision.app/data). Use the key as X-API-Key on REST or on this MCP endpoint: 120 req/min\n instead of the shared anonymous budget, plus 100 units a day of metered calls (history, positions:\n get_funding_history, get_open_interest_history, get_funding_settlements, get_hl_whales, get_history...),\n and to upgrade later to Pro/Bot (10,000 / 100,000 metered calls a day, exports, webhook alerts). Ask the user for the email\n first; do not invent one.",
"inputSchema": {
"type": "object",
"title": "get_api_keyArguments",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"title": "Email",
"description": "The owner's email address; the key is issued to it once."
}
}
},
"annotations": {
"title": "Get a free API key",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}[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.
| Parameter | Type | Description |
|---|---|---|
| end | any | End of the window, ISO date (YYYY-MM-DD) or datetime, UTC. |
| limit | integer | Maximum number of rows to return. |
| start | any | Start of the window, ISO date (YYYY-MM-DD) or datetime, UTC. |
| symbol | any | Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT). |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
| dataset * | string | Dataset id: liquidations | funding_settlements | funding_hourly | open_interest_hourly | hl_positions | lighter_positions (see list_history_packages). |
| exchange | any | Venue id (binance, bybit, okx, bitget, hyperliquid, gate, htx, kucoin, mexc, bingx, aster, kraken, gmx) or 'all' where the tool allows it. |
Subscribe 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_pct (median annualised funding across venues) | oi_chg_1h_pct | oi_chg_24h_pct (Binance+Bybit+OKX, in coins) | liq_1h_usd | liq_24h_usd | price_chg_1h_pct | price_chg_24h_pct (Binance mark) | long_pct (mean long share of accounts) — the SAME definitions test_rule backtests, so test a rule first and alert on it after; op = gt | lt. Example: symbol='BTC', metric='funding_apr_pct', op='gt', threshold=50. The payload carries the value, the threshold and every other metric as context. Checked every 60 s. type='position': YOUR OWN position (symbol, side, entry, leverage, notional_usd, venue) — fires when it is within max_dist_pct of its liquidation price, computed every 60 s from the venue's maintenance-margin tier and the live mark (same numbers as check_position); again only when it gets a whole percent closer. 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.
| Parameter | Type | Description |
|---|---|---|
| op | any | Comparison: gt (greater than) | lt (less than). |
| url * | string | HTTPS endpoint that will receive the POST deliveries. |
| side | any | type=position: long | short. |
| type * | string |
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.
| Parameter | Type | Description |
|---|---|---|
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
{
"name": "list_alerts",
"title": "List alerts",
"description": "The webhook alert subscriptions that belong to the caller's API key (read-only): id,\n type, url, filters (symbol, min_usd, x_normal, max_dist_pct) and delivery health:\n last_status (HTTP code or error of the last delivery), fails (consecutive failures; a\n subscription pauses itself at 20) and active. Call it to find the id for delete_alert or\n to check why alerts stopped arriving. Needs a Pro or Bot key, from the MCP connection's\n X-API-Key header or the api_key argument; without one it returns an error object, not\n an exception.",
"inputSchema": {
"type": "object",
"title": "list_alertsArguments",
"properties": {
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
}
}
},
"annotations": {
"title": "List alerts",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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).
| Parameter | Type | Description |
|---|---|---|
| id * | integer | Numeric id of the subscription, from list_alerts or create_alert. |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
{
"name": "delete_alert",
"title": "Delete alert",
"description": "Permanently delete one webhook alert subscription. DESTRUCTIVE and not reversible:\n deliveries to its URL stop at once and its signing secret is discarded (create_alert\n issues a new one). Only a subscription owned by the caller's API key can be deleted;\n an id belonging to another key returns {\"deleted\": false} and changes nothing. id: the\n number returned by create_alert or list_alerts. Needs a Pro or Bot key (X-API-Key header\n of the MCP connection, or api_key).",
"inputSchema": {
"type": "object",
"title": "delete_alertArguments",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"title": "Id",
"description": "Numeric id of the subscription, from list_alerts or create_alert."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
}
}
},
"annotations": {
"title": "Delete alert",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}[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, max_dist_pct. Each row carries the account address; pass it to get_hl_account. Snapshot age is in age_s.
| Parameter | Type | Description |
|---|---|---|
| coin | any | Base asset, e.g. BTC, ETH, SOL (no USDT suffix). |
| side | any | Position side: long | short. Omit for both. |
| sort | string | Sort order of the result, as listed in the description. |
| limit | integer | Maximum number of rows to return. |
| min_usd | number | Only rows at or above this notional in USD. |
| max_dist_pct | any | Only positions whose liquidation price is within this many percent of the mark price. |
{
"name": "get_hl_whales",
"title": "Hyperliquid whale positions",
"description": "[measured] Leveraged positions of about 13,600 Hyperliquid accounts (the 10,000 largest plus\n every account seen trading) with the\n exchange-reported liquidation price, closest to liquidation first (sort='value' = largest\n first). Filters: coin (BTC), side (long|short), min_usd, max_dist_pct. Each row carries the\n account address; pass it to get_hl_account. Snapshot age is in age_s.",
"inputSchema": {
"type": "object",
"title": "get_hl_whalesArguments",
"properties": {
"coin": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Coin",
"default": null,
"description": "Base asset, e.g. BTC, ETH, SOL (no USDT suffix)."
},
"side": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Side",
"default": null,
"description": "Position side: long | short. Omit for both."
},
"sort": {
"type": "string",
"title": "Sort",
"default": "distance",
"description": "Sort order of the result, as listed in the description."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 50,
"description": "Maximum number of rows to return."
},
"min_usd": {
"type": "number",
"title": "Min Usd",
"default": 100000,
"description": "Only rows at or above this notional in USD."
},
"max_dist_pct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Max Dist Pct",
"default": null,
"description": "Only positions whose liquidation price is within this many percent of the mark price."
}
}
},
"annotations": {
"title": "Hyperliquid whale positions",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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 to a recognised exchange, custodian, market maker, DEX pool or bridge: a possible sale, reported at any size), large_move (at least $100k to an address we do not recognise), hl_position (a watched Hyperliquid position opened, closed or changed by a quarter and $1M+). Each event carries the sender's share of supply when it was added to the list, the destination label and its source, amount, best-effort USD and an explorer link. Filters: hours (1-720), chain (ethereum|solana|hyperliquid), type, symbol (coin). The watch list itself: GET https://liquidvision.app/api/v1/detective/watch.
| Parameter | Type | Description |
|---|---|---|
| type | any | Type id, one of the values listed in the description. |
| chain | any | Chain filter: ethereum | solana | hyperliquid. Omit for all. |
| hours | integer | Look-back window in hours. |
| limit | integer | Maximum number of rows to return. |
| symbol | any | Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT). |
{
"name": "get_detective_events",
"title": "Detective events",
"description": "[measured] Detective: what the watched large holders did. Private wallets with a large\n share of a token's supply (Ethereum, Solana) and Hyperliquid accounts with a large share of\n a contract's open interest are watched live. Event types: to_exchange (a watched wallet sent\n tokens to a recognised exchange, custodian, market maker, DEX pool or bridge: a possible sale,\n reported at any size), large_move (at least $100k to an address we do not recognise),\n hl_position (a watched Hyperliquid position opened, closed or changed by a quarter and $1M+).\n Each event carries the sender's share of supply when it was added to the list, the destination\n label and its source, amount, best-effort USD and an explorer link. Filters: hours (1-720),\n chain (ethereum|solana|hyperliquid), type, symbol (coin). The watch list itself: GET\n https://liquidvision.app/api/v1/detective/watch.",
"inputSchema": {
"type": "object",
"title": "get_detective_eventsArguments",
"properties": {
"type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Type",
"default": null,
"description": "Type id, one of the values listed in the description."
},
"chain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Chain",
"default": null,
"description": "Chain filter: ethereum | solana | hyperliquid. Omit for all."
},
"hours": {
"type": "integer",
"title": "Hours",
"default": 24,
"description": "Look-back window in hours."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 50,
"description": "Maximum number of rows to return."
},
"symbol": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Symbol",
"default": null,
"description": "Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT)."
}
}
},
"annotations": {
"title": "Detective events",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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. PRICE: the full map is a metered call ($0.005, or a key). Without a key this tool returns the free summary: USD on each side of the price and the largest level on each side.
| Parameter | Type | Description |
|---|---|---|
| range | string | Price range around the current price: 12h | 1d | 3d | 7d (and 'max' where stated), the traded range of that window. |
| symbol * | string | Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT). |
{
"name": "get_lighter_liquidation_map",
"title": "Lighter liquidation map (measured)",
"description": "[measured, RISK AHEAD, Lighter] REAL open positions on Lighter (zk perp DEX; crypto plus\n equity indices, stocks, forex, commodities) binned by Lighter's own liquidation price. Not a\n model. Use this for Lighter; get_hl_liquidation_map for Hyperliquid; get_liquidation_map\n (modeled) for the CEXs. Accounts are discovered from the public trade stream, so coverage\n (covered_long_pct/covered_short_pct of venue open interest) grows with time. Returns long/short\n notional per bin, cumulative curves and the largest positions. range: 12h | 1d | 3d | 7d | max.\n PRICE: the full map is a metered call ($0.005, or a key). Without a key this tool returns the\n free summary: USD on each side of the price and the largest level on each side.",
"inputSchema": {
"type": "object",
"title": "get_lighter_liquidation_mapArguments",
"required": [
"symbol"
],
"properties": {
"range": {
"type": "string",
"title": "Range",
"default": "1d",
"description": "Price range around the current price: 12h | 1d | 3d | 7d (and 'max' where stated), the traded range of that window."
},
"symbol": {
"type": "string",
"title": "Symbol",
"description": "Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT)."
}
}
},
"annotations": {
"title": "Lighter liquidation map (measured)",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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.
| Parameter | Type | Description |
|---|---|---|
| coin | any | Base asset, e.g. BTC, ETH, SOL (no USDT suffix). |
| side | any | Position side: long | short. Omit for both. |
| sort | string | Sort order of the result, as listed in the description. |
| limit | integer | Maximum number of rows to return. |
| min_usd | number | Only rows at or above this notional in USD. |
| max_dist_pct | any | Only positions whose liquidation price is within this many percent of the mark price. |
{
"name": "get_lighter_whales",
"title": "Lighter whales",
"description": "[measured] Leveraged positions on Lighter with the exchange-reported liquidation price,\n closest to liquidation first (sort='value' = largest first). Filters: coin (BTC), side\n (long|short), min_usd, max_dist_pct. address is the Lighter account index, l1_address the\n wallet. Snapshot age is in age_s.",
"inputSchema": {
"type": "object",
"title": "get_lighter_whalesArguments",
"properties": {
"coin": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Coin",
"default": null,
"description": "Base asset, e.g. BTC, ETH, SOL (no USDT suffix)."
},
"side": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Side",
"default": null,
"description": "Position side: long | short. Omit for both."
},
"sort": {
"type": "string",
"title": "Sort",
"default": "distance",
"description": "Sort order of the result, as listed in the description."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 50,
"description": "Maximum number of rows to return."
},
"min_usd": {
"type": "number",
"title": "Min Usd",
"default": 100000,
"description": "Only rows at or above this notional in USD."
},
"max_dist_pct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Max Dist Pct",
"default": null,
"description": "Only positions whose liquidation price is within this many percent of the mark price."
}
}
},
"annotations": {
"title": "Lighter whales",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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).
| Parameter | Type | Description |
|---|---|---|
| address * | string | Hyperliquid account address (0x...). |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
{
"name": "get_hl_account",
"title": "Hyperliquid wallet lookup",
"description": "[measured] One Hyperliquid account by address: live positions (size, entry, mark,\n liquidation price, distance to liquidation, leverage, unrealized PnL), account value, and\n its archived position snapshots. History depth: 24 h free, 31 days Pro, everything since\n 2026-09-27 on Bot (key from the MCP connection's X-API-Key header, or api_key).",
"inputSchema": {
"type": "object",
"title": "get_hl_accountArguments",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"title": "Address",
"description": "Hyperliquid account address (0x...)."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
}
}
},
"annotations": {
"title": "Hyperliquid wallet lookup",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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 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.
| Parameter | Type | Description |
|---|---|---|
| asset_class | any | Asset class filter: stocks | indices | commodities | forex. Omit for all. |
{
"name": "get_tokenized_stocks",
"title": "Tokenized stocks",
"description": "[measured] Tokenized stocks, indices, ETFs, commodities, FX, rates and pre-IPO names traded as\n PERPS on DEXs (Lighter, Hyperliquid builder markets, Ostium and gTrade): one row per underlying (NVDA, TSLA,\n S&P 500, Gold, EUR/USD, Anthropic...) with every venue's mark, open interest, 24 h volume,\n funding APR and the price gap between venues in bps. asset_class filters: equity |\n crypto_equity | etf | index | commodity | fx | rates | preipo. Use get_hl_builder_markets for\n the raw Hyperliquid HIP-3 list by dex.",
"inputSchema": {
"type": "object",
"title": "get_tokenized_stocksArguments",
"properties": {
"asset_class": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Asset Class",
"default": null,
"description": "Asset class filter: stocks | indices | commodities | forex. Omit for all."
}
}
},
"annotations": {
"title": "Tokenized stocks",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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.
No parameters.
{
"name": "get_hl_builder_markets",
"title": "Hyperliquid builder markets",
"description": "[measured] Perp markets deployed on Hyperliquid by third parties (HIP-3 builder dexs):\n equity indices, single stocks, commodities and pre-IPO names such as xyz:SP500 or xyz:GOLD.\n For each dex: its markets (coin named dex:COIN), open interest in USD (one side), 24h\n volume, mark price, hourly funding and its APR. These are NOT in get_open_interest or\n get_funding_rates, which cover Hyperliquid's own crypto listing. Live from Hyperliquid,\n cached 2 minutes. No arguments.",
"inputSchema": {
"type": "object",
"title": "get_hl_builder_marketsArguments",
"properties": {}
},
"annotations": {
"title": "Hyperliquid builder markets",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}[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 market: mark, 24h change, OI and its 24h/7d change, 24h volume and turnover (volume/OI), hourly funding and APR, liquidations 24h/7d (count, USD, long share), and gap_bps = HIP-3 mark vs the mean mark of other venues listing the same underlying (Lighter, Ostium, gTrade). `leaders` lists OI growth/decline, funding extremes, most liquidated, widest gap. dex filters to one builder (xyz, io, para...); sort = oi | volume | funding | liq | gap | oi_change; limit caps the markets list. OI changes are null until the archive is that old (started 2026-10-31). No key needed.
| Parameter | Type | Description |
|---|---|---|
| dex | any | HIP-3 builder dex id. Omit for all builder markets. |
| sort | string | Sort order of the result, as listed in the description. |
| limit | integer | Maximum number of rows to return. |
{
"name": "get_hip3_markets",
"title": "Hyperliquid HIP-3 board",
"description": "[measured] The HIP-3 board: Hyperliquid's builder-deployed perp markets (equity indices,\n stocks, commodities, pre-IPO names; coins named dex:COIN such as xyz:SP500) with what the live\n list alone cannot tell you. Per dex: OI, share, 24h/7d OI change, 24h volume, liquidations.\n Per market: mark, 24h change, OI and its 24h/7d change, 24h volume and turnover (volume/OI),\n hourly funding and APR, liquidations 24h/7d (count, USD, long share), and gap_bps = HIP-3 mark\n vs the mean mark of other venues listing the same underlying (Lighter, Ostium, gTrade).\n `leaders` lists OI growth/decline, funding extremes, most liquidated, widest gap.\n dex filters to one builder (xyz, io, para...); sort = oi | volume | funding | liq | gap | oi_change;\n limit caps the markets list. OI changes are null until the archive is that old (started\n 2026-10-31). No key needed.",
"inputSchema": {
"type": "object",
"title": "get_hip3_marketsArguments",
"properties": {
"dex": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Dex",
"default": null,
"description": "HIP-3 builder dex id. Omit for all builder markets."
},
"sort": {
"type": "string",
"title": "Sort",
"default": "oi",
"description": "Sort order of the result, as listed in the description."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 50,
"description": "Maximum number of rows to return."
}
}
},
"annotations": {
"title": "Hyperliquid HIP-3 board",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}LiquidVision.app: crypto derivatives data for agents. READ-ONLY: every tool reads public market data; nothing here trades, signs, stores or touches private data. The conclusion tools (brief, regime, cascades, dispersion, carry, microstructure, maps, tokenized stocks, accuracy) and the live snapshots (open interest, funding rates, long/short, recent liquidation events) need no key. History and positions (OI/funding history, settlements, order books, candles, whale positions, exports) are metered: a free key (get_api_key tool) includes 100 such calls a day, Pro 10,000 and Bot 100,000; send the key as X-API-Key when connecting, otherwise those tools return an explanation. Open interest and funding across 13 venues (Binance, MEXC, Bybit, Bitget, Hyperliquid, HTX, Gate, OKX, KuCoin, BingX, Aster, Kraken, GMX on Arbitrum) exactly as the exchanges publish them — no haircuts, no doubling; /accuracy audits that against the exchanges every 10 minutes. START WITH: list_markets (what exists), then get_market_brief (one coin, one JSON) or the computed views. Prefer the computed views, which return conclusions rather than ticks: get_liquidation_cascades (cascades as events), get_positioning_regime (price x OI), get_funding_dispersion (cross-venue arbitrage), get_microstructure (spread/depth/basis), get_market_brief (one deterministic risk brief) and explain_market (the brief behind a question such as 'why did BTC drop?'). Liquidation events cover Binance and Bitget (both exchange-throttled to one order per contract per second), OKX, Bybit, HTX, Gate, Kraken, Aster, GMX, Lighter and Hyperliquid whales, so totals are a floor for the whole market. Liquidation maps are MODELED estimates, except the measured Hyperliquid and Lighter maps (get_hl_liquidation_map, get_lighter_liquidation_map). Tool docstrings are tagged [measured] or [modeled]. Symbols are BASEUSDT. PRICED ANSWERS (say so in their docstring): get_fear_greed, get_smart_money, get_crypto_twitter, search_twitter, create_watch, pretrade_check, get_x_user, get_x_user_tweets, get_x_mentions, get_x_tweet, get_x_trends, get_hl_top_traders, get_trader_profile, get_prediction_markets, get_defi_liquidations, get_precedents, test_rule, scan_rule, check_position on all venues, attest_snapshot. Pay with a key's daily units, prepaid credits (buy_credits), a $1 day pass (buy_day_pass), or per call over x402 / MPP / Nevermined / Skyfire (terms: https://liquidvision.app/api/v1/x402). FRESHNESS: answers carry 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. Check it before acting on a number. History exports (CSV) and webhook alerts for bots: liquidvision.app/pricing.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| min_usd | number | cascade / hl_near_liq: minimum size in USD. |
| leverage | any | position: leverage. |
| threshold | any | condition: the threshold. |
| max_dist_pct | number | position / hl_near_liq: alert within this % of liquidation. |
| notional_usd | any | position: size in USD (optional). |
{
"name": "create_watch",
"title": "Create watch",
"description": "[alert] Buy a 30-day watch with ONE payment and no account, checked every 60 seconds:\n your own position within max_dist_pct of its liquidation price (type=position), a metric of a\n coin crossing a threshold (condition), a liquidation cascade ending (cascade), or a Hyperliquid\n whale near liquidation (hl_near_liq). Returns watch_id; read its events with get_watch (free).\n Priced: $0.20 (x402, MPP), 40 prepaid credits, or a key's daily units.",
"inputSchema": {
"type": "object",
"title": "create_watchArguments",
"required": [
"type"
],
"properties": {
"op": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Op",
"default": null,
"description": "condition: gt or lt."
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url",
"default": null,
"description": "Optional HTTPS URL that also receives each event."
},
"side": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Side",
"default": null,
"description": "position: long or short."
},
"type": {
"type": "string",
"title": "Type",
"description": "position | condition | cascade | hl_near_liq"
},
"entry": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Entry",
"default": null,
"description": "position: entry price."
},
"venue": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Venue",
"default": null,
"description": "position: one venue id (optional)."
},
"metric": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Metric",
"default": null,
"description": "condition: funding_apr_pct | oi_chg_1h_pct | oi_chg_24h_pct | liq_1h_usd | liq_24h_usd | price_chg_1h_pct | price_chg_24h_pct | long_pct"
},
"symbol": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Symbol",
"default": null,
"description": "Coin or contract, e.g. BTC. Required except for cascade."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
},
"min_usd": {
"type": "number",
"title": "Min Usd",
"default": 1000000,
"description": "cascade / hl_near_liq: minimum size in USD."
},
"leverage": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Leverage",
"default": null,
"description": "position: leverage."
},
"threshold": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Threshold",
"default": null,
"description": "condition: the threshold."
},
"max_dist_pct": {
"type": "number",
"title": "Max Dist Pct",
"default": 3,
"description": "position / hl_near_liq: alert within this % of liquidation."
},
"notional_usd": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Notional Usd",
"default": null,
"description": "position: size in USD (optional)."
}
}
},
"annotations": {
"title": "Create watch",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}{
"name": "check_position",
"title": "Liquidation price of a position",
"description": "[measured + modeled] Your own position against the market in one call: the liquidation\n price on each venue from THAT venue's maintenance-margin tier at this notional (read from\n the exchanges' public tables, 'estimated' where none is published), the distance from the\n current mark, how much modeled CEX leverage and how much MEASURED Hyperliquid leverage sits\n between the mark and your liquidation price on your side, the funding cost per day at the\n venue's live rate, and how often in our hourly archive price moved at least that far against\n your side within 24 h and 72 h (a frequency, not a forecast). Assumes isolated margin and\n ignores fees, so the real level is slightly nearer the entry. ONE venue (venue= given) is free; the\n 12-venue comparison is an answer we price: $0.02 per call (x402), 4 prepaid credits, or a key's daily quota.",
"inputSchema": {
"type": "object",
"title": "check_positionArguments",
"required": [
"side",
"entry",
"leverage"
],
"properties": {
"coin": {
"type": "string",
"title": "Coin",
"default": "BTC",
"description": "Base asset, e.g. BTC, ETH, SOL (no USDT suffix)."
},
"side": {
"type": "string",
"title": "Side",
"description": "Position side: long | short."
},
"entry": {
"type": "number",
"title": "Entry",
"description": "Entry price in quote currency (USDT)."
},
"venue": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Venue",
"default": null,
"description": "Venue id (binance, bybit, okx, bitget, gate, kucoin, kraken, hyperliquid, htx, mexc, bingx, aster). Omit for every venue side by side."
},
"leverage": {
"type": "number",
"title": "Leverage",
"description": "Leverage, e.g. 10 for 10x (isolated margin assumed)."
},
"notional_usd": {
"type": "number",
"title": "Notional Usd",
"default": 10000,
"description": "Position size in USD (price x quantity)."
}
}
},
"annotations": {
"title": "Liquidation price of a position",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "get_history",
"title": "History",
"description": "[measured] Historical rows as CSV, for backtests. dataset: liquidations | funding_settlements\n (since 2024-09) | funding_hourly | open_interest_hourly | hl_positions (Hyperliquid whale\n positions with liquidation prices). start/end are ISO dates (UTC). Without a key or on the free\n tier only the last 24 hours are available; Pro: any 31-day window; Bot: full history. The key\n is read from the MCP connection's X-API-Key header, or pass api_key. limit caps rows here\n (max 5000); for bulk use download_url with the same key.",
"inputSchema": {
"type": "object",
"title": "get_historyArguments",
"required": [
"dataset"
],
"properties": {
"end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "End",
"default": null,
"description": "End of the window, ISO date (YYYY-MM-DD) or datetime, UTC."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 500,
"description": "Maximum number of rows to return."
},
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Start",
"default": null,
"description": "Start of the window, ISO date (YYYY-MM-DD) or datetime, UTC."
},
"symbol": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Symbol",
"default": null,
"description": "Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT)."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
},
"dataset": {
"type": "string",
"title": "Dataset",
"description": "Dataset id: liquidations | funding_settlements | funding_hourly | open_interest_hourly | hl_positions | lighter_positions (see list_history_packages)."
},
"exchange": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Exchange",
"default": null,
"description": "Venue id (binance, bybit, okx, bitget, hyperliquid, gate, htx, kucoin, mexc, bingx, aster, kraken, gmx) or 'all' where the tool allows it."
}
}
},
"annotations": {
"title": "History",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| Type id, one of the values listed in the description. |
| entry | any | type=position: entry price (USDT). |
| venue | any | type=position: venue whose margin tiers and mark to use (default binance). |
| metric | any | Condition metric: funding_apr_pct | oi_chg_1h_pct | oi_chg_24h_pct | liq_1h_usd | liq_24h_usd | price_chg_1h_pct | price_chg_24h_pct | long_pct. |
| symbol | any | Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT). |
| api_key | any | LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection. |
| min_usd | number | Only rows at or above this notional in USD. |
| leverage | any | type=position: leverage, e.g. 20. |
| x_normal | number | Minimum cascade size as a multiple of the coin's normal minute of liquidations. |
| threshold | any | Threshold the metric is compared with, in the metric's own unit (percent or USD). |
| max_dist_pct | number | Only positions whose liquidation price is within this many percent of the mark price. |
| notional_usd | any | type=position: position size in USD (default 10,000). |
{
"name": "create_alert",
"title": "Create alert",
"description": "Subscribe an HTTPS URL to push alerts instead of polling (Pro: 3, Bot: 20 subscriptions).\n type='condition': YOUR OWN trigger on one symbol — fires when `metric` `op` `threshold` becomes\n true (edge-triggered: once per crossing, again only after it was false). metric = funding_apr_pct\n (median annualised funding across venues) | oi_chg_1h_pct | oi_chg_24h_pct (Binance+Bybit+OKX, in\n coins) | liq_1h_usd | liq_24h_usd | price_chg_1h_pct | price_chg_24h_pct (Binance mark) | long_pct\n (mean long share of accounts) — the SAME definitions test_rule backtests, so test a rule first and\n alert on it after; op = gt | lt. Example: symbol='BTC', metric='funding_apr_pct', op='gt',\n threshold=50. The payload carries the value, the threshold and every other metric as context.\n Checked every 60 s.\n type='position': YOUR OWN position (symbol, side, entry, leverage, notional_usd, venue) — fires when it is\n within max_dist_pct of its liquidation price, computed every 60 s from the venue's maintenance-margin\n tier and the live mark (same numbers as check_position); again only when it gets a whole percent closer.\n type='cascade': a liquidation cascade just ended, over min_usd and x_normal times the coin's\n normal minute. type='hl_near_liq': a Hyperliquid whale position over min_usd within\n max_dist_pct of its liquidation price. type='cluster_sweep': price reached one of the 10\n largest modeled liquidation-map clusters (size over min_usd; no symbol = BTC, ETH, SOL), sent\n 3 min later with modeled vs actually liquidated USD. Returns the signing secret ONCE: verify header\n X-LiquidVision-Signature = hex HMAC-SHA256(secret, raw body). Needs a Pro or Bot key.",
"inputSchema": {
"type": "object",
"title": "create_alertArguments",
"required": [
"type",
"url"
],
"properties": {
"op": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Op",
"default": null,
"description": "Comparison: gt (greater than) | lt (less than)."
},
"url": {
"type": "string",
"title": "Url",
"description": "HTTPS endpoint that will receive the POST deliveries."
},
"side": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Side",
"default": null,
"description": "type=position: long | short."
},
"type": {
"type": "string",
"title": "Type",
"description": "Type id, one of the values listed in the description."
},
"entry": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Entry",
"default": null,
"description": "type=position: entry price (USDT)."
},
"venue": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Venue",
"default": null,
"description": "type=position: venue whose margin tiers and mark to use (default binance)."
},
"metric": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Metric",
"default": null,
"description": "Condition metric: funding_apr_pct | oi_chg_1h_pct | oi_chg_24h_pct | liq_1h_usd | liq_24h_usd | price_chg_1h_pct | price_chg_24h_pct | long_pct."
},
"symbol": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Symbol",
"default": null,
"description": "Contract as BASEUSDT, e.g. BTCUSDT, ETHUSDT, SOLUSDT (1000PEPE and kPEPE fold to PEPEUSDT)."
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Key",
"default": null,
"description": "LiquidVision API key (lv_...). Omit when the key is sent as the X-API-Key header on the connection."
},
"min_usd": {
"type": "number",
"title": "Min Usd",
"default": 1000000,
"description": "Only rows at or above this notional in USD."
},
"leverage": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Leverage",
"default": null,
"description": "type=position: leverage, e.g. 20."
},
"x_normal": {
"type": "number",
"title": "X Normal",
"default": 8,
"description": "Minimum cascade size as a multiple of the coin's normal minute of liquidations."
},
"threshold": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Threshold",
"default": null,
"description": "Threshold the metric is compared with, in the metric's own unit (percent or USD)."
},
"max_dist_pct": {
"type": "number",
"title": "Max Dist Pct",
"default": 3,
"description": "Only positions whose liquidation price is within this many percent of the mark price."
},
"notional_usd": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Notional Usd",
"default": null,
"description": "type=position: position size in USD (default 10,000)."
}
}
},
"annotations": {
"title": "Create alert",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}