POST
/
v1
/
liquidation
curl --request POST \
  --url https://api-evm.orderly.network/v1/liquidation \
  --header 'Content-Type: application/json' \
  --header 'orderly-account-id: <orderly-account-id>' \
  --header 'orderly-key: <orderly-key>' \
  --header 'orderly-signature: <orderly-signature>' \
  --header 'orderly-timestamp: <orderly-timestamp>' \
  --data '{
  "liquidation_id": 123,
  "ratio_qty_request": 123,
  "extra_liquidation_ratio": 123,
  "limit_price": {
    "symbol": 123
  },
  "symbols": {
    "ratio_qty_request": 123,
    "symbol": "<string>"
  }
}'
{
  "success": true,
  "timestamp": 1702989203989,
  "data": {
    "liquidation_id": 123,
    "timestamp": 123,
    "type": "<string>",
    "positions_by_perp": [
      {
        "abs_liquidator_fee": 1.152279,
        "cost_position_transfer": 65.84448,
        "liquidator_fee": 0.0175,
        "position_qty": 41.6,
        "symbol": "PERP_NEAR_USDC",
        "transfer_price": 1.5828
      }
    ]
  }
}

Headers

orderly-timestamp
string
required
orderly-account-id
string
required
orderly-key
string
required
orderly-signature
string
required

Body

application/json
liquidation_id
integer
required
ratio_qty_request
integer
required
extra_liquidation_ratio
integer
limit_price
object
required

Liquidator’s instruction to let the system reject the liquidation claim if the following condition applies: if position_qty > 0, reject if mark_price > limit_price; if position_qty < 0, reject if mark_price < limit_price

symbols
object

For high risk tiers only

Response

200 - application/json
success
boolean
required
timestamp
integer
data
object
required