Skip to main content
POST
/
v1
/
claim_insurance_fund
Claim insurance fund
curl --request POST \
  --url https://api.orderly.org/v1/claim_insurance_fund \
  --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 '
{
  "claim_id": 123,
  "symbol": "<string>",
  "qty_request": 123,
  "limit_price": {
    "symbol": 123
  }
}
'
{
  "success": true,
  "data": {
    "liquidation_id": 101,
    "timestamp": 1663313562090,
    "positions_by_perp": [
      {
        "symbol": "PERP_BTC_USDC",
        "abs_liquidator_fee": 1.152279,
        "cost_position_transfer": 21.002786,
        "liquidator_fee": 0.006,
        "position_qty": 0.00017,
        "transfer_price": 123545.8
      }
    ]
  },
  "timestamp": 1702989203989
}

Headers

​
orderly-timestamp
string
required

Timestamp of the signed request in milliseconds.

​
orderly-account-id
string
required

Account ID of the authenticated account.

​
orderly-key
string
required

Public orderly key used to sign the request.

​
orderly-signature
string
required

Signature of the request payload generated with the orderly key.

Body

application/json
​
claim_id
number
required
​
symbol
string
required
​
qty_request
number
required

Quantity to be claimed from insurance fund

​
limit_price
object

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

Response

200 - application/json

OK

​
success
boolean
required

Indicates whether the request was successful.

Example:

true

​
data
object
required
​
timestamp
integer

Server timestamp in milliseconds.

Example:

1702989203989