---
title: "Last-24h liquidations for one base symbol"
method: GET
path: "/api/market/liquidations"
tags: ["public-market-data"]
---

# Last-24h liquidations for one base symbol

`GET /api/market/liquidations`

## Request

- Base URL: `https://api.coinrithm.com`
- URL: `https://api.coinrithm.com/api/market/liquidations`
- Auth: none required

Keyless 24-hour liquidation summary for one base symbol (a coin such
as `BTC`, or a TradFi perpetual base such as `XAU` or `NVDA`) across
the Binance USD-M forced-order stream and the OKX liquidation-orders
channel: long/short totals, per-venue totals, and the biggest and
latest events.

Sums cover only what CoinRithm's capture saw while running.
`capturedPct` is a lower bound of capture uptime for the window, not
exchange completeness, and is null when no capture was recorded (a
gap, never "no liquidations"). Binance publishes at most the latest
liquidation per symbol per second. `long` means a long position was
liquidated (a forced sell). The base is the venue's own base symbol,
so two assets that share a ticker share a row set; for a stock ticker
pass `venue=okx`, because Binance's feed carries crypto contracts
only. `truncated` is true when the row cap was reached and totals are
then a lower bound. An unknown base returns 200 with zero totals.
The response is shared-cached for about 60 seconds.

## Query parameters

- `base` string, required
- `limit` integer
- `venue` 'binance' | 'okx'

## Response `200`

24h totals, per-venue coverage and the biggest/latest events

- PublicLiquidationsResponse
  - `version` integer, required
  - `generatedAt` string, date-time, required
  - `base` string, required
  - `venue` string, nullable, required: The venue filter applied, or null for every captured venue.
  - `window` PublicLiquidationsWindow, required
    - `from` string, date-time, required
    - `to` string, date-time, required
    - `hours` integer, required
  - `totals` PublicLiquidationTotals, required: Captured liquidation sums in USD (rounded to whole dollars) and event counts.
    - `longUsd` number, required
    - `shortUsd` number, required
    - `totalUsd` number, required
    - `longEvents` integer, required
    - `shortEvents` integer, required
    - `events` integer, required
  - `venues` PublicLiquidationVenueSummary[], required: One entry per venue with captured events in the window.
    - `venue` string, required: `binance` or `okx`.
    - `longUsd` number, required
    - `shortUsd` number, required
    - `totalUsd` number, required
    - `longEvents` integer, required
    - `shortEvents` integer, required
    - `events` integer, required
    - `instIds` string[], required
    - `capturedPct` number, nullable, required: Lower bound of capture uptime for the window, 0-100. Null when no capture was recorded: a gap, never evidence of no liquidations.
    - `lastEventAt` string, date-time, nullable, required
  - `biggest` PublicLiquidationEvent[], required: Largest events by notional.
    - `venue` string, required
    - `instId` string, required: Venue instrument id, e.g. `BTCUSDT` or `XAU-USDT-SWAP`.
    - `eventAt` string, date-time, required
    - `liquidatedSide` string, required: `long` (a long was liquidated, a forced sell) or `short`.
    - `contracts` number, required: Size in venue contract units.
    - `price` number, required: OKX bankruptcy price; Binance liquidation order price.
    - `notionalUsd` number, required: Notional in USDT, rounded to cents.
    - `marketUrl` string, uri, required
  - `latest` PublicLiquidationEvent[], required: Most recent events.
    - `venue` string, required
    - `instId` string, required: Venue instrument id, e.g. `BTCUSDT` or `XAU-USDT-SWAP`.
    - `eventAt` string, date-time, required
    - `liquidatedSide` string, required: `long` (a long was liquidated, a forced sell) or `short`.
    - `contracts` number, required: Size in venue contract units.
    - `price` number, required: OKX bankruptcy price; Binance liquidation order price.
    - `notionalUsd` number, required: Notional in USDT, rounded to cents.
    - `marketUrl` string, uri, required
  - `truncated` boolean, required: True when the row cap was reached; totals are then a lower bound.
  - `source` PublicMarketFeedSource, required
    - `provider` string, required
    - `venues` PublicMarketFeedVenue[], required
      - `venue` string, required
      - `name` string, required
      - `url` string, uri, required
      - `feed` string, required: The venue's public feed the collector reads.
      - `note` string: Venue-specific coverage limitation, when published.
    - `method` string, required: How rows are selected and valued.
    - `coverage` string: Which markets are collected, and the gap caveat.

## Other responses

- `400`: Missing `base`, invalid value or unknown query parameter
- `429`: Public request rate limit exceeded; honor `Retry-After`.
- `500`: Liquidations temporarily unavailable

---

[API](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api.md) · [All operations](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/revisions/28fb59f285fe?raw)