v4

latestOpenAPI 3.0.3Apache 2.02026-08-0854311207.3 KB

List BLP Liquidations

List the backstop liquidations the authenticated Backstop Liquidity Provider (BLP) account received, most recent first by default.

Each record is one absorption and carries the same fields as a frame on the backstop WebSocket channel, so a participant that missed frames while disconnected can replay them from here rather than reconstructing them from trade history. Records do not identify the liquidated account.

margin is the net margin transferred with the positions. It is negative when the absorption carried bad debt — the fund returned more isolated margin than the account's balance covered.

Like the other BLP routes, this one is restricted to program participants: an authenticated account that is not enrolled receives a 404, the same response as an account requesting a route that does not exist for it.

get/v1/blp/liquidations

Query parameters

start_timestampinteger

Start timestamp in milliseconds

Example:1767225600000
end_timestampinteger

End timestamp in milliseconds

Example:1767229200000
cursorinteger

Pagination cursor. Pass the liquidation ID of the last record from the previous page to fetch the next page. Paging follows the sort direction (strictly older records when sort=desc, strictly newer when sort=asc).

Example:1234567890
sort'desc' | 'asc'

Time sort direction. desc (default) returns the most recent liquidations first; asc returns the oldest first.

Response

BLP liquidation history.

moreboolean required

More data available

Example response

{
  "data": [
    {
      "liquidation_id": 1234567890,
      "timestamp": 1767225600000,
      "margin": "150.00",
      "trades": [
        {
          "trade_id": 1,
          "instrument_id": 1,
          "quantity": "10.00",
          "price": "100.00"
        }
      ]
    }
  ]
}