Skip to main content
GET
GET /perps/liquidations: Liquidation History
Sign each request with a fresh HMAC signature. The cURL and HTTP header values below are placeholders, not reusable credentials. For runnable signing code, use request signing examples.
Detected liquidations, oldest first. Every row carries its evidence class — confirmed, inferred or unknown — so you can tell a liquidation observed directly from one reconstructed from account state. Fields that cannot be determined are null, never 0 or false. Detection covers the gated account-snapshot universe only. Part of the Perps Data product; scope analytics.read.

Query Parameters

string
required
Start of the window. Accepts RFC3339, unix seconds or unix milliseconds.
string
required
End of the window. Same formats as from. The window may span at most 31 days; a wider range is refused with 400 range_too_large.
string
Only liquidations on this instrument, by its venue-native id. Matches [A-Za-z0-9._-]{1,32}. Omit for all instruments.
string
Only liquidations for this account. A 40-hex address, with or without the 0x prefix.
string
A comma-separated subset of confirmed, inferred, unknown. Defaults to all three. unknown is never hidden, so a subset that omits it still returns unknown rows. An unrecognised value is refused with 400 invalid_evidence.
integer
default:"200"
Rows per page, 1–1000.

Response

Liquidations in data, oldest first, each with its evidence class. When has_more is true, page forward by passing next_from_ms back as from.
array
object
What the detection could and could not observe over the window.
boolean
true when more rows remain beyond this page.
integer
Present when has_more is true. Pass it back as from to read the next page.

Example