Skip to main content
GET
Liquidations
Likely liquidations are position closes detected at a large loss. Filter by type, instrument, min_notional, address, and after. Responses are newest first and include has_more plus an opaque next_cursor. Send that value as cursor with the same filters to continue through the fixed traversal:
Cursors expire after 24 hours and cannot be reused on the general position events route. A malformed cursor returns HTTP 400 with {"error":"invalid cursor"}. An expired cursor returns {"error":"cursor has expired"}. Changing a filter returns HTTP 400 with a clean cursor-mismatch message. Start again without the cursor in each case.

Authorizations

x-api-key
string
header
required

Query Parameters

type
string

opened | closed | increased | reduced | flipped

instrument
string

Instrument id/symbol/asset.

min_notional
number

Only >= this USD size.

address
string

One account.

after
string

Only rows after this time (Unix s or ms).

limit
integer

Max rows.

cursor
string

Opaque next_cursor from the preceding page. Reuse the same route and filters within 24 hours.

Response

Success