Method Name
private/get_liquidation_history
private/get_liquidation_history
Required minimum session key permission level is read_only
Parameters
| end_timestampinteger End timestamp of the event history in ms since Unix epoch (default current time) |
| start_timestampinteger Start timestamp of the event history in ms since Unix epoch (default 0) |
| subaccount_idinteger Subaccount id (must be set if wallet is blank) |
| walletstring Wallet address (if set, subaccount_id ignored) |
Response
| idstring or integerrequired |
| resultarray of objectsrequired |
| result[].auction_idstringrequired Unique ID of the auction |
| result[].auction_typestringrequired Type of auction enum solventinsolvent |
| result[].end_timestampinteger or nullrequired Timestamp of the auction end (in ms since UNIX epoch), or null if not ended |
| result[].feestringrequired Fee paid by the subaccount |
| result[].start_timestampintegerrequired Timestamp of the auction start (in ms since UNIX epoch) |
| result[].subaccount_idintegerrequired Liquidated subaccount ID |
| result[].tx_hashstringrequired Hash of the transaction that started the auction |
| result[].bidsarray of objectsrequired List of auction bid events |
| result[].bids[].cash_receivedstringrequired Cash received by the subaccount for the liquidation. For the liquidated accounts this is the amount the liquidator paid to buy out the percentage of the portfolio. For the liquidator account, this is the amount they received from the security module (if positive) or the amount they paid for the bid (if negative) |
| result[].bids[].discount_pnlstringrequired Realized PnL due to liquidating or being liquidated at a discount to mark portfolio value |
| result[].bids[].percent_liquidatedstringrequired Percent of the subaccount that was liquidated |
| result[].bids[].realized_pnlstringrequired Realized PnL of the auction bid, assuming positions are closed at mark price at the time of the liquidation |
| result[].bids[].realized_pnl_excl_feesstringrequired Realized PnL of the auction bid, excluding fees from total cost basis, assuming positions are closed at mark price at the time of the liquidation |
| result[].bids[].timestampintegerrequired Timestamp of the bid (in ms since UNIX epoch) |
| result[].bids[].tx_hashstringrequired Hash of the bid transaction |
| result[].bids[].amounts_liquidatedobjectrequired Amounts of each asset that were closed |
| result[].bids[].positions_realized_pnlobjectrequired Realized PnL of each position that was closed |
| result[].bids[].positions_realized_pnl_excl_feesobjectrequired Realized PnL of each position that was closed, excluding fees from total cost basis |
Example
{request_example_shell}{request_example_javascript}{request_example_python}The above command returns JSON structured like this:
{response_example_json}