---
title: "GET /public/get_last_settlements_by_currency"
method: GET
path: "/public/get_last_settlements_by_currency"
tags: ["Market Data", "Public"]
---

# GET /public/get_last_settlements_by_currency

`GET /public/get_last_settlements_by_currency`

Retrieves historical settlement, delivery, and bankruptcy events from all instruments within a given currency.

**Settlement vs. delivery:** Settlement is a daily event (at 08:00 UTC) for futures and perpetual positions that converts unrealized profit and loss into realized profit and loss. Option positions do not settle. Delivery is a one-time event that occurs when a futures or options contract expires — any remaining open position is closed at the delivery price. Delivery does not apply to perpetual or spot instruments. Both events take place at 08:00 UTC, which is why they are sometimes conflated.

Results can be filtered by settlement type and timestamp. Use pagination parameters (`count` and `continuation`) to retrieve large settlement histories. This data is useful for analyzing historical contract settlements and understanding market events.

**Note on `profit_loss` and `session_profit_loss`:** Because this is a public endpoint, these fields are **platform-wide aggregates**, not per-account values. `profit_loss` is the sum of realized P&L of all position holders at the settlement price. `session_profit_loss` is the sum of each holder's total session P&L (realized + unrealized) across all participants.

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

## Query parameters

- `currency` 'BTC' | 'ETH' | 'USDC' | 'USDT' | 'EURR', required — Currency, i.e `"BTC"`, `"ETH"`, `"USDC"`
- `type` 'settlement' | 'delivery' | 'bankruptcy' — The type of settlement event. `settlement`: daily settlement of futures and perpetual positions at 08:00 UTC, converting unrealized profit and loss into realized profit and loss (option positions do not settle). `delivery`: one-time expiration of a futures or options contract at 08:00 UTC, closing any remaining open position at the delivery price (does not apply to perpetual or spot instruments). `bankruptcy`.
- `count` integer
- `continuation` string
- `search_start_timestamp` integer — The timestamp (milliseconds since the Unix epoch)

## Response `200`

Success response

- PublicSettlementResponse
  - `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 event. `settlement`: daily settlement of futures and perpetual positions at 08:00 UTC, converting unrealized profit and loss into realized profit and loss (option positions do not settle). `delivery`: one-time expiration of a futures or options contract at 08:00 UTC, closing any remaining open position at the delivery price (does not apply to perpetual or spot instruments). `bankruptcy`.

---

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