GET /accounts/liquidations/takes

Returns backstop take-all liquidation events. These occur when a deeply distressed account’s positions are taken by a backstop account.

Request


curl https://zo-mainnet.n1.xyz/accounts/liquidations/takes

Response


[
  {
    "time": "2024-01-15T10:30:00Z",
    "actionId": 12345,
    "takerAccountId": 1,
    "takerSide": "bid",
    "marketId": 0,
    "settlementPrice": 97500,
    "baseSize": 500000,
    "makerAccountId": 42,
    "bankruptcyPrice": 97000
  }
]

Response Fields

TakeAllInfo Object

Field	Type	Description
`time`	string	ISO 8601 timestamp of the take event
`actionId`	number	Action ID that produced this take
`takerAccountId`	number	Backstop account that took the position
`takerSide`	string	Side of the taker (`"bid"` or `"ask"`)
`marketId`	number	Market where the position was taken
`settlementPrice`	number	Price at which the position was settled (raw mantissa)
`baseSize`	number	Size of the position taken (raw)
`makerAccountId`	number	Distressed account whose position was taken
`bankruptcyPrice`	number	Bankruptcy price of the position (raw mantissa)

[!NOTE] Price and size values are raw mantissa values. Divide by the market’s priceDecimals and sizeDecimals (from GET /info) to get human-readable values.

Example: Python


import requests
 
API_URL = "https://zo-mainnet.n1.xyz"
 
def get_liquidation_takes():
    resp = requests.get(f"{API_URL}/accounts/liquidations/takes")
    return resp.json()
 
takes = get_liquidation_takes()
for take in takes:
    print(
        f"[{take['time']}] Market {take['marketId']}: "
        f"Account {take['makerAccountId']} taken by {take['takerAccountId']} "
        f"size={take['baseSize']} @ settlement={take['settlementPrice']}"
    )

[!IMPORTANT] Take-all events represent the new backstop liquidation path introduced in v15. Terminal liquidations for deeply distressed accounts now flow through this take-all mechanism instead of the legacy final-step liquidation. Liquidation history reports these events as BankruptcyOrTake.