LiquidVision — Crypto Derivatives Data

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

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

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

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

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

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

{
  "type": "object",
  "properties": {
    "result": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Result",
      "type": "array"
    }
  },
  "required": [
    "result"
  ],
  "title": "get_funding_ratesOutput"
}

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.

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

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.

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

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

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

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.

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

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.

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

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

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

{
  "type": "object",
  "properties": {
    "result": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Result",
      "type": "array"
    }
  },
  "required": [
    "result"
  ],
  "title": "get_open_interestOutput"
}

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

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

{
  "type": "object",
  "properties": {
    "result": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Result",
      "type": "array"
    }
  },
  "required": [
    "result"
  ],
  "title": "get_open_interest_historyOutput"
}

Bucketed funding-rate history per exchange for a symbol (e.g. BTCUSDT) over the last `minutes` (5-20160).

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

{
  "type": "object",
  "properties": {
    "result": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Result",
      "type": "array"
    }
  },
  "required": [
    "result"
  ],
  "title": "get_funding_historyOutput"
}

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

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

{
  "type": "object",
  "properties": {
    "result": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Result",
      "type": "array"
    }
  },
  "required": [
    "result"
  ],
  "title": "get_long_short_ratioOutput"
}

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

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

{
  "type": "object",
  "properties": {
    "result": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Result",
      "type": "array"
    }
  },
  "required": [
    "result"
  ],
  "title": "get_liquidationsOutput"
}

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

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

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.

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

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

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

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

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

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

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

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

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

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

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

[modeled] Liquidation map for a perp symbol (e.g. BTCUSDT): estimated liquidation-cluster notional per price bin, split by leverage tier (10x/25x/50x/100x) and by exchange (binance/bybit/okx or 'all'), plus cumulative long/short curves from the current price outward. range: 12h | 1d | 3d | 7d. Validation vs realized liquidations: see get_accuracy.

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

[measured] Liquidation map for Hyperliquid, not a model: leveraged positions of the ~3000 largest accounts binned by the exchange-reported liquidation price, long/short notional per bin, cumulative curves and the largest positions. Partial coverage: large accounts only. range: 12h | 1d | 3d | 7d | max (±100%, recommended: large accounts run low leverage).

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

[modeled] Liquidation heatmap: estimated cluster intensity per price bin over time (grid[time][bin]) with the price path. range: 12h | 1d | 3d | 7d.

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

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

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

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.

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

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

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

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

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

Cumulative volume delta split by trade size (retail <$10K, mid <$100K, large <$1M, whale >$1M). Whale-vs-retail divergence = smart-money signal.

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

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.

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

Get a free LiquidVision API key for this agent's owner, by email, without a browser. Works for a NEW email only (an existing account's key is never returned; its owner sees it at liquidvision.app/data). Use the key as X-API-Key on REST or on this MCP endpoint for 300 req/min instead of the shared anonymous budget, and to upgrade later to Pro/Bot (history exports, webhook alerts). Ask the user for the email first; do not invent one.

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

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

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

Subscribe an HTTPS URL to push alerts instead of polling (Pro: 3, Bot: 20 subscriptions). type='cascade': a liquidation cascade just ended, over min_usd and x_normal times the coin's normal minute. type='hl_near_liq': a Hyperliquid whale position over min_usd within max_dist_pct of its liquidation price. type='cluster_sweep': price reached one of the 10 largest modeled liquidation-map clusters (size over min_usd; no symbol = BTC, ETH, SOL), sent 3 min later with modeled vs actually liquidated USD. Returns the signing secret ONCE: verify header X-LiquidVision-Signature = hex HMAC-SHA256(secret, raw body). Needs a Pro or Bot key.

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

Alert subscriptions of this key, with delivery status (last_status, fails, active).

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

Delete one alert subscription of this key by id.

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

[measured] Leveraged positions of the 3000 largest Hyperliquid accounts with the exchange-reported liquidation price, closest to liquidation first (sort='value' = largest first). Filters: coin (BTC), side (long|short), min_usd, max_dist_pct. Each row carries the account address; pass it to get_hl_account. Snapshot age is in age_s.

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

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

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