public-market-data

Last-24h liquidations for one base symbol

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.

get/api/market/liquidations

Request

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

Query parameters

basestring required

Base symbol, case-insensitive (BTC, XAU).

limitinteger

Events in each of biggest and latest, 1-50 (default 10).

venue'binance' | 'okx'

Restrict to one venue; omit for every captured venue.

Response

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

versioninteger required
generatedAtstring date-time required
basestring required
venuestring nullable required

The venue filter applied, or null for every captured venue.

truncatedboolean required

True when the row cap was reached; totals are then a lower bound.

Changes

No recorded changes to this operation across all 1 revision of this API.