Get positions under liquidation

Limit: 10 requests per 1 second per IP address

GET /v1/public/liquidation

Returns a list of positions that are currently being liquidated. These are positions where the margin has dropped below the maintenance margin requirement and are in the process of being closed by the liquidation engine.

GET /v1/public/liquidation

Get positions under liquidation

cURL

curl --request GET \
  --url https://api.orderly.org/v1/public/liquidation

200

{
  "success": true,
  "data": {
    "meta": {
      "total": 9,
      "records_per_page": 25,
      "current_page": 1
    },
    "rows": [
      {
        "timestamp": 1685298157704,
        "type": "liquidated",
        "liquidation_id": 1730,
        "positions_by_perp": [
          {
            "symbol": "PERP_BTC_USDC",
            "position_qty": -0.22457,
            "liquidator_fee": 0.015
          }
        ]
      }
    ]
  },
  "timestamp": 1702989203989
}

Query Parameters

start_t · number

start time range that you wish to query, noted that the time stamp is a 13-digits timestamp.

end_t · number

end time range that you wish to query, noted that the time stamp is a 13-digits timestamp.

page · integer

the page you wish to query. start from 1

size · integer

Default: 60

Response

200 - application/json

Success

success · boolean · required

Indicates whether the request was successful.

Example:

true

data · object · required

Show child attributes

timestamp · integer

Server timestamp in milliseconds.

Example:

1702989203989