> For the complete documentation index, see [llms.txt](https://docs.pangolin.exchange/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pangolin.exchange/pangoperps/trading-api/liquidations/claim-insurance-fund.md).

# 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
}
```
