Skip to main content
GET
Get API public v1 live risk liquidations summary

Authorizations

X-API-Key
string
header
required

Query Parameters

coin
string
since
string
default:7d

Lookback window: digits followed by m, h or d (e.g. 30m, 6h, 7d).

Pattern: ^[0-9]+[mhd]$

Response

OK

availability
object
required
avgClosedPnl
number<double>
required
avgPenaltyFee
number<double>
required
bucketSizeMs
integer<int64>
required
byCoin
object[] | null
required
count
integer<int64>
required
freshness
object
required
generatedAt
string
required
longEvents
integer<int64>
required

Count of LONG liquidation events in the window (longEvents+shortEvents=count).

longNotional
number<double>
required

Notional of liquidated LONG positions in the window (side split of totalNotional; longNotional+shortNotional=totalNotional).

shortEvents
integer<int64>
required

Count of SHORT liquidation events in the window.

shortNotional
number<double>
required

Notional of liquidated SHORT positions in the window (side split of totalNotional).

since
string
required
timeline
object[] | null
required
totalClosedPnl
number<double>
required
totalNotional
number<double>
required
totalPenaltyFees
number<double>
required
wallets
integer<int64>
required
$schema
string<uri>
read-only

A URL to the JSON Schema for this object.

Example:

"https://api.coinversa.ai/schemas/LiquidationSummaryBody.json"

byCohort
object[] | null

Cohort (pnl_tier) split of the same window, sorted by totalNotional desc; wallets with no cohort classification aggregate under tier 'unclassified'. Only populated on GET /live/risk/liquidations/summary — omitted from the other consumers of this shape (risk overview, coin risk snapshot/history) to keep those hot paths from running an extra query.

coin
string