GET /market/liquidations
GET

/v1/market/liquidations

Liquidations on perpetuals. OKX (top level): its latest filled liquidation orders (up to 100): longs and shorts liquidated, sizes and USD values, the largest ones. Gate (gate): hourly totals by side over the last 24 hours and 7 days, each UTC day of the week and the three heaviest hours. Streams (streams): every liquidation Binance, Bybit and OKX streamed, collected by xrpl.to since 5 October 2026: totals by venue and side over 24 hours and 7 days, per UTC day, the day's largest, and whether each venue's collector is connected (Binance streams at most one per symbol per second, a floor). A source that does not answer carries unavailable: true

AuthNone — works without a key

Request

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

Response

No example was fetched for this page. Send the request to see a live response.
Shapeas documented
{
  success,
  asset,
  venue,
  instrument,
  contractSize,
  window { from, to, events },
  longsLiquidated { count, size, usd },
  shortsLiquidated { count, size, usd },
  largest[],
  gate {
    venue,
    instrument,
    last24h {
      from,
      to,
      hours,
      longsLiquidated { size, usd },
      shortsLiquidated { size, usd }
    },
    last7d { … },
    days[] {
      date,
      hours,
      longsLiquidated,
      shortsLiquidated
    },
    largestHours[] {
      hourStart,
      longsLiquidated,
      shortsLiquidated
    }
  },
  streams {
    collectingSince,
    venues {
      <venue>: {
        connected,
        collectingSince,
        lastMessageAt,
        last24h,
        last7d { longs, shorts { count, size, usd } }
      }
    },
    days[] { date, venues },
    largest24h[] { venue, side, size, price, usd, time },
    note
  },
  note,
  source
}

What it does

Liquidations on perpetuals. OKX (top level): its latest filled liquidation orders (up to 100): longs and shorts liquidated, sizes and USD values, the largest ones. Gate (gate): hourly totals by side over the last 24 hours and 7 days, each UTC day of the week and the three heaviest hours. Streams (streams): every liquidation Binance, Bybit and OKX streamed, collected by xrpl.to since 5 October 2026: totals by venue and side over 24 hours and 7 days, per UTC day, the day's largest, and whether each venue's collector is connected (Binance streams at most one per symbol per second, a floor). A source that does not answer carries unavailable: true

OpenAPI