Crypto Liquidation Chart: Long vs Short by Exchange

omnial/market-liquidation-chart

Given a token symbol, an exchange, and a candlestick interval, returns a time series of long and short liquidation volume in USD for that market -- the total value of leveraged positions forcibly closed in each interval, plus which exchanges contributed to each bucket.

activeper callv3

Price

Up to $0.0164 per call; you pay what the call used

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.

Data source

Binance, OKX, Bybit, Bitget, Hyperliquid and other exchanges

Liquidation data from the exchange you select: Binance by default, or OKX, Bybit, Bitget, Hyperliquid and others.

Use it

Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

For developers: the calls your assistant makes

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/market-liquidation-chart" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/market-liquidation-chart" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/market-liquidation-chart", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/market-liquidation-chart", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0164

Updated: Oct 27, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "symbol"
  ],
  "properties": {
    "to": {
      "type": "string",
      "minLength": 1,
      "description": "End of time range. Accepts Unix seconds (1706745600) or date string (2024-02-01). Example: 2024-02-01."
    },
    "from": {
      "type": "string",
      "minLength": 1,
      "description": "Start of time range. Accepts Unix seconds (1704067200) or date string (2024-01-01). Example: 2024-01-01."
    },
    "limit": {
      "type": "integer",
      "default": 500,
      "maximum": 4500,
      "minimum": 1,
      "description": "Results per page. Example: 500. Defaults to 500."
    },
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Token ticker symbol like BTC or ETH. Example: BTC."
    },
    "exchange": {
      "enum": [
        "Binance",
        "OKX",
        "Bybit",
        "Bitget",
        "Hyperliquid",
        "Gate",
        "HTX",
        "Bitmex",
        "Bitfinex",
        "CoinEx",
        "Aster",
        "Lighter"
      ],
      "type": "string",
      "default": "Binance",
      "description": "Exchange name. Can be Binance, OKX, Bybit, Bitget, Hyperliquid, Gate, HTX, Bitmex, Bitfinex, CoinEx, Aster, or Lighter. Example: Binance. Defaults to \"Binance\"."
    },
    "interval": {
      "enum": [
        "1m",
        "3m",
        "5m",
        "15m",
        "30m",
        "1h",
        "4h",
        "6h",
        "8h",
        "12h",
        "1d",
        "1w"
      ],
      "type": "string",
      "default": "1h",
      "description": "Candlestick interval — bucket size for each point in the liquidation chart series: 1m, 3m, 5m, 15m, 30m, 1h, 4h, 6h, 8h, 12h, 1d, or 1w. This endpoint uses interval only; it does NOT accept time_range. Use from/to to bound the series. Example: 1h. Defaults to \"1h\"."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "timestamp": {
            "type": "integer",
            "description": "Unix seconds marking the bucket."
          },
          "long_liquidation_usd": {
            "type": "number",
            "description": "Total USD value of forced long-position closures in this bucket."
          },
          "short_liquidation_usd": {
            "type": "number",
            "description": "Total USD value of forced short-position closures in this bucket."
          },
          "contributing_exchanges": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Exchange name(s) whose liquidations were aggregated into this bucket."
          }
        },
        "additionalProperties": false
      },
      "description": "One entry per interval bucket, typically oldest first. Empty when no liquidations occurred in the requested range (e.g. an ETH/OKX 4h date-range query)."
    },
    "meta": {
      "type": "object",
      "properties": {
        "cached": {
          "type": "boolean",
          "description": "Whether this response was served from the provider's cache."
        }
      },
      "additionalProperties": false
    },
    "$schema": {
      "type": "null",
      "description": "Always null. The raw response's $schema value is a document pointer that names the upstream data pipe's own host, so it is stripped at the shaping layer; the key stays present with a null value rather than being omitted."
    }
  },
  "description": "The liquidation chart response.",
  "additionalProperties": false
}