XRPL.to
GET /market/liquidation-levels
GET

/v1/market/liquidation-levels

ESTIMATED liquidation levels (a heatmap): where positions opened in the last 7 days on Binance, Bybit and OKX would be liquidated, in 1% price bands up to 25% either side (longs below the price, shorts above), from hourly open-interest changes and an assumed leverage mix stated in the result; levels the price has crossed are dropped. A model, not a reading of anyone's positions

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/market/liquidation-levels
Query parameterValueDescription
assetXRP|BTC|ETH (default XRP)
curl 'https://api.xrpl.to/v1/market/liquidation-levels'

Response

200Example response580 ms · just now · 4.0 KB · 174 lines
https://api.xrpl.to/v1/market/liquidation-levels
{
  "success": true,
  "asset": "XRP",
  "estimate": true,
  "price": 1.2545,
  "at": "2026-11-01T07:08:26.116Z",
  "window": {
    "from": "2026-10-25T08:00:00.000Z",
    "to": "2026-11-01T07:08:26.116Z",
    "hours": 168
  },
  "venues": [
    "Binance",
    "Bybit",
    "OKX"
  ],
  "openInterestShare": 0.567,
  "assumptions": {
    "leverage": {
      "5x": 0.25,
      "10x": 0.3,
      "20x": 0.2,
      "50x": 0.15,
      "100x": 0.1
    },
    "maintenanceMarginRate": 0.005,
    "margin": "isolated, fees ignored",
    "rangePct": 25
  },
  "longs": {
    "totalUsd": 56390724,
    "levels": [
      {
        "fromPct": 0,
        "toPct": -1,
        "priceLow": 1.241955,
        "priceHigh": 1.2545,
        "usd": 1277875,
        "cumulativeUsd": 1277875
      },
      {
        "fromPct": -1,
        "toPct": -2,
        "priceLow": 1.22941,
        "priceHigh": 1.241955,
        "usd": 5012763,
        "cumulativeUsd": 6290637
      },
      {
        "fromPct": -2,
        "toPct": -3,
        "priceLow": 1.216865,
        "priceHigh": 1.22941,
        "usd": 3983793,
        "cumulativeUsd": 10274430
      },
      {
        "fromPct": -3,
        "toPct": -4,
        "priceLow": 1.20432,
        "priceHigh": 1.216865,
        "usd": 874939,
        "cumulativeUsd": 11149369
      },
      {
        "fromPct": -4,
        "toPct": -5,
        "priceLow": 1.191775,
        "priceHigh": 1.20432,
        "usd": 6610594,
        "cumulativeUsd": 17759963
      }
    ],
    "largest": [
      {
        "fromPct": -9,
        "toPct": -10,
        "priceLow": 1.12905,
        "priceHigh": 1.141595,
        "usd": 8646692,
        "cumulativeUsd": 33841679
      },
      {
        "fromPct": -10,
        "toPct": -11,
        "priceLow": 1.116505,
        "priceHigh": 1.12905,
        "usd": 7781446,
        "cumulativeUsd": 41623124
      },
      {
        "fromPct": -4,
        "toPct": -5,
        "priceLow": 1.191775,
        "priceHigh": 1.20432,
        "usd": 6610594,
        "cumulativeUsd": 17759963
      }
    ]
  },
  "shorts": {
    "totalUsd": 66314817,
    "levels": [
      {
        "fromPct": 0,
        "toPct": 1,
        "priceLow": 1.2545,
        "priceHigh": 1.267045,
        "usd": 3733160,
        "cumulativeUsd": 3733160
      },
      {
        "fromPct": 1,
        "toPct": 2,
        "priceLow": 1.267045,
        "priceHigh": 1.27959,
        "usd": 4905410,
        "cumulativeUsd": 8638569
      },
      {
        "fromPct": 2,
        "toPct": 3,
        "priceLow": 1.27959,
        "priceHigh": 1.292135,
        "usd": 469007,
        "cumulativeUsd": 9107577
      },
      {
        "fromPct": 3,
        "toPct": 4,
        "priceLow": 1.292135,
        "priceHigh": 1.30468,
        "usd": 6459398,
        "cumulativeUsd": 15566975
      },
      {
        "fromPct": 4,
        "toPct": 5,
        "priceLow": 1.30468,
        "priceHigh": 1.317225,
        "usd": 6425103,
        "cumulativeUsd": 21992077
      }
    ],
    "largest": [
      {
        "fromPct": 8,
        "toPct": 9,
        "priceLow": 1.35486,
        "priceHigh": 1.367405,
        "usd": 10437662,
        "cumulativeUsd": 34503663
      },
      {
        "fromPct": 9,
        "toPct": 10,
        "priceLow": 1.367405,
        "priceHigh": 1.37995,
        "usd": 9537236,
        "cumulativeUsd": 44040898
      },
      {
        "fromPct": 18,
        "toPct": 19,
        "priceLow": 1.48031,
        "priceHigh": 1.492855,
        "usd": 7608463,
        "cumulativeUsd": 57345551
      }
    ]
  },
  "note": "An ESTIMATE, not a reading of anyone's positions: positions opened over the last 7 days on the venues named (each rise in their hourly open interest, at that hour's typical price, on both sides), spread over an assumed leverage mix, liquidated where an isolated position's equity meets maintenance margin, and dropped once the price crossed that level. longs.levels are price bands below the price wh…",
  "source": "Binance (hourly candles, open interest), Bybit, OKX public market data; xrpl.to model"
}

Long arrays and strings are shortened in the example; Send request for the full answer.

Shapeas documented
{
  success,
  asset,
  estimate: true,
  price,
  at,
  window { from, to, hours },
  venues[],
  openInterestShare,
  assumptions {
    leverage,
    maintenanceMarginRate,
    margin,
    rangePct
  },
  longs {
    totalUsd,
    levels[] {
      fromPct,
      toPct,
      priceLow,
      priceHigh,
      usd,
      cumulativeUsd
    },
    largest[]
  },
  shorts { … },
  note,
  source
}

What it does

ESTIMATED liquidation levels (a heatmap): where positions opened in the last 7 days on Binance, Bybit and OKX would be liquidated, in 1% price bands up to 25% either side (longs below the price, shorts above), from hourly open-interest changes and an assumed leverage mix stated in the result; levels the price has crossed are dropped. A model, not a reading of anyone's positions

OpenAPI
PrevGET/market/liquidationsNextGET/market/global