---
title: "GET /private/get_lsp_usage"
method: GET
path: "/private/get_lsp_usage"
tags: ["lsp", "Private"]
---

# GET /private/get_lsp_usage

`GET /private/get_lsp_usage`

Retrieves the current per-cooldown-group assignment usage for the authenticated LSP (Liquidity Support Program) participant subaccount within its current fixed cooldown window.

Must be called with an API key belonging to the LSP participant subaccount itself — returns an error if the authenticated account is not an LSP participant.

Instruments are bucketed into one of 7 cooldown groups (6 crypto tiers plus a real-world-asset group); each group has its own limit (`pct`, as a percentage of the participant's equity), fixed-window usage (`used`, in USD — this does not decay smoothly; it stays flat until the window closes at `cooldown_end`, then resets to `0` in one step), and the window's timing (`cooldown_start`/`cooldown_end`). Neither the absolute limit nor the remaining capacity is computed for you — derive it from `pct`, `used`, and the participant's own equity from `private/get_account_summary`. Even a self-computed remaining-capacity figure won't reflect the additional margin/leverage-derived cap applied at assignment time, which isn't exposed on any user-facing endpoint.

**Scope:** `account:read`

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

## Response `200`

Success response

- PrivateGetLspUsageResponse
  - `jsonrpc` '2.0', required — The JSON-RPC version (2.0)
  - `id` integer — The id that was sent in the request
  - `result` object, required
    - `cooldown_period_ms` integer, required — Length of the rolling cooldown window in milliseconds.
    - `groups` LspGroupUsage, required — Per-cooldown-group assignment usage, keyed by group (`"1"`-`"6"` for crypto tiers, `"rwa"` for real-world-asset instruments). Groups with no configured limit and no usage may be absent.

## Other responses

- `401` — Success response

---

[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)