---
title: "GET /private/get_settlement_history_by_instrument"
method: GET
path: "/private/get_settlement_history_by_instrument"
tags: ["Trading", "Private"]
---

# GET /private/get_settlement_history_by_instrument

`GET /private/get_settlement_history_by_instrument`

Retrieves settlement, delivery, and bankruptcy events for a specific instrument that have affected your account. Settlements occur when futures or options contracts expire and are settled at the delivery price.

Results can be filtered by settlement type and timestamp. Use pagination parameters (`count` and `continuation`) to retrieve large settlement histories. This method is useful for tracking settlement events for a specific instrument.

**Scope:** `trade:read`

[Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Fget_settlement_history_by_instrument)

## Query parameters

- `instrument_name` string, required — Unique instrument identifier
- `type` 'settlement' | 'delivery' | 'bankruptcy' — The type of settlement. `settlement`, `delivery` or `bankruptcy`.
- `count` integer
- `continuation` string
- `search_start_timestamp` integer — The timestamp (milliseconds since the Unix epoch)

## Response `200`

Success response

- PrivateSettlementResponse
  - `jsonrpc` '2.0', required — The JSON-RPC version (2.0)
  - `id` integer — The id that was sent in the request
  - `result` object, required
    - `continuation` string, required — Continuation token for pagination.
    - `settlements` Settlement[], required
      - `funding` number, required — funding (in base currency ; settlement for perpetual product only)
      - `funded` number — funded amount (bankruptcy only)
      - `index_price` number, required — underlying index price at time of event (in quote currency; settlement and delivery only)
      - `instrument_name` string, required — instrument name (settlement and delivery only)
      - `mark_price` number — mark price for at the settlement time (in quote currency; settlement and delivery only)
      - `position` number, required — position size (in quote currency; settlement and delivery only)
      - `profit_loss` number — Platform-wide aggregate realized profit and loss for this settlement event, in base currency. This is the sum of the realized P&L of every position holder at the settlement or delivery price — it is **not** a per-account value. Present for `settlement` and `delivery` types only.
      - `session_bankruptcy` number — value of session bankruptcy (in base currency; bankruptcy only)
      - `session_profit_loss` number, required — Platform-wide aggregate total session profit and loss for this settlement event, in base currency. This is the sum of each position holder's session P&L (combining realized and unrealized components) across all users who held positions in the instrument — it is **not** a per-account value.
      - `session_tax` number — total amount of paid taxes/fees (in base currency; bankruptcy only)
      - `session_tax_rate` number — rate of paid taxes/fees (in base currency; bankruptcy only)
      - `socialized` number — the amount of the socialized losses (in base currency; bankruptcy only)
      - `timestamp` integer, required — The timestamp (milliseconds since the Unix epoch)
      - `type` 'settlement' | 'delivery' | 'bankruptcy', required — The type of settlement. `settlement`, `delivery` or `bankruptcy`.

---

[API](https://skmtc.net/deribit/apis/deribit-api-2.md) · [All operations](https://skmtc.net/deribit/apis/deribit-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deribit/deribit-api-2/versions/430b3f0bc67c/schema)