Crypto Liquidation Chart: Long vs Short by Exchange

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

{
  "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, oldest first on the populated fixture observed. Empty when no liquidations occurred in the requested range (observed on the ETH/OKX 4h date-range fixture)."
    },
    "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, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": false
}