Liquidations

public/get_liquidation_history

Returns a paginated history of liquidation auctions, newest first, for a single subaccount or across all of them, optionally bounded by a start/end timestamp window over the auction start. Each entry gives the auctioned subaccount, whether the auction was solvent or insolvent, the fee charged at start, the start and end timestamps, and the bids that filled it with the fraction of the account each absorbed and the cash it moved.

post/public/get_liquidation_history

Request

  • Base URL: https://api.derive.xyz/v3
  • URL: https://api.derive.xyz/v3/public/get_liquidation_history
  • Auth: none declared

Request body

end_timestampinteger nullable

End of the window, unix milliseconds (default: unbounded).

pageinteger nullable

Page number, 1-based (default 1).

page_sizeinteger nullable

Results per page (default 100, max 1000).

start_timestampinteger nullable

Start of the window, unix milliseconds (default 0).

subaccount_idinteger nullable

Response

Success

Changes

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