- Accounts
- Wallet Authentication
- Deposit/Withdrawal
- Settle PnL
- Order Management
- Custom Fee Structure
- Delegate Signer
- Referral System
- Broker Info
- System Info
- USDC Faucet
- Registration
- Key Management
- Account/User Info
- Account Notifications
- Account Config
- Delegate Signer
- Order Management
- Liquidations
- Assets/Withdraw/Settle PnL
- Positions
- Funding
- User Data
- Trading Campaigns
- Fee Setting
- Points Campaign
- Referral Program
- TradingView
- Funding Rates
- Market Info
User Flows
General API
User API
Trading API
Broker API
Market Data API
Claim Liquidated Positions
Limit: 5 requests per 1 second per IP address
POST /v1/liquidation
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
The limit price for each symbol in the liquidation claim
For high risk tiers only
Field dedicated to high risk symbols liquidations type only (symbols with liquidation tier = 2), where a liquidator can specific the ratio he wish to liquidates per symbol
Only relevant if this is a liquidation of type high tier (symbols with liquidation tier = 2)
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
Body
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
The limit price for each symbol in the liquidation claim
For high risk tiers only
Field dedicated to high risk symbols liquidations type only (symbols with liquidation tier = 2), where a liquidator can specific the ratio he wish to liquidates per symbol
Only relevant if this is a liquidation of type high tier (symbols with liquidation tier = 2)
Response
OR "claim"
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
}
]
}
}