Claim Insurance Fund

#Endpoint

POST /v1/claim_insurance_fund

Mainnet: https://api.orderly.org/v1/claim_insurance_fund

Testnet: https://testnet-api.orderly.org/v1/claim_insurance_fund

Rate limit: 5 requests per second.

#Authentication

Send the signed-request headers with an application/json body.

• orderly-timestamp — required; signed-request timestamp in milliseconds.
• orderly-account-id — required; authenticated account ID.
• orderly-key — required; public API key.
• orderly-signature — required; signature generated for the request.

#Request body

• claim_id (number, required).
• symbol (string, required).
• qty_request (number, required) — quantity requested from the insurance fund.
• limit_price (object, optional) — may provide a per-symbol limit price. When position_qty is positive, the claim is rejected if mark_price is above the limit. When position_qty is negative, it is rejected if mark_price is below the limit. The nested limit_price.symbol value is a required number when this object is supplied.

#Response

HTTP 200 — application/json. success is a required boolean. The required data object contains liquidation_id (integer), timestamp (integer), and positions_by_perp (array). The response-root timestamp is server time in milliseconds.

Each returned position can include symbol (string), abs_liquidator_fee, cost_position_transfer, liquidator_fee, position_qty, and transfer_price (numbers).

{
  "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
}