---
title: "Get Starbase Risk Limits"
method: GET
path: "/api/v2/private/get_starbase_risk_limits"
tags: ["Portfolio Management"]
---

# Get Starbase Risk Limits

`GET /api/v2/private/get_starbase_risk_limits`

## Request

- Base URL: `http://195.138.37.5:4410`
- URL: `http://195.138.37.5:4410/api/v2/private/get_starbase_risk_limits`
- Auth: HTTP bearer

Returns the effective position ("risk") limits for the authenticated portfolio, one entry per underlying (currency pair).

Each numeric field is resolved per field: a portfolio override wins when that field is set, otherwise the currency-pair default is used. A field unset at both levels is omitted. `-1` means the limit is explicitly unlimited (distinct from unset). The call is read-only and does not change limits.

Only underlyings that have a currency-pair default or an override for this portfolio are included. Overrides that belong to other portfolios do not create an entry.

Pass `currency` to select one underlying. The value is the currency-pair name returned in `currency` (for example `BTC_USDC`). Matching is case-insensitive and ignores separators, so `btc-usdc` and `BTCUSDC` resolve to the same pair. An unknown name returns HTTP 400. A known pair with no configured limit for this portfolio returns an empty list.

The portfolio is resolved from the authenticated session. There is no parameter to query another portfolio.

This endpoint is rate-limited to 1 request per minute per portfolio on each REST gateway. The A and B gateways enforce this cap independently. Exceeding the limit returns HTTP 429.

## Query parameters

- `currency` string

## Response `200`

Effective position limits for the authenticated portfolio. May be empty.

- GetStarbaseRiskLimitsResponse
  - `jsonrpc` '2.0', required: The JSON-RPC version (2.0)
  - `id` integer: The id that was sent in the request
  - `result` StarbaseRiskLimit[], required: Effective position limits, one entry per underlying. May be empty.
    - `currency` string, required: Currency-pair name (for example `BTC_USDC`). Pass this value back as the `currency` query parameter to read the same underlying.
    - `sm_max_future_position_size` number, nullable: Standard Margin: maximum net future position size if filled. USD notional for inverse contracts, quantity for linear contracts. Omitted when unset. `-1` means unlimited.
    - `pm_max_future_open_order_size` number, nullable: Portfolio Margin: maximum total size of future open orders per side. USD notional for inverse contracts, quantity for linear contracts. Omitted when unset. `-1` means unlimited.
    - `pm_max_option_open_contracts` number, nullable: Portfolio Margin: maximum total size of option open contracts per side, in contracts. Omitted when unset. `-1` means unlimited.
    - `max_open_orders` integer, nullable: Maximum open orders on derivatives across all instruments of this currency pair. Applies to both Standard Margin and Portfolio Margin. Omitted when unset. `-1` means unlimited.
    - `sm_max_open_orders_per_instrument` integer, nullable: Standard Margin: maximum open orders per instrument. Omitted when unset. `-1` means unlimited.
    - `pm_max_future_open_orders` integer, nullable: Portfolio Margin: maximum future open orders per side. Omitted when unset. `-1` means unlimited.
    - `pm_max_option_open_orders` integer, nullable: Portfolio Margin: maximum option open orders per side. Omitted when unset. `-1` means unlimited.

## Other responses

- `400`: Unknown `currency`. The message is `unknown currency: <value>`.
- `401`: Missing or invalid `Authorization` header.
- `429`: Per-portfolio rate limit for this endpoint exceeded. Default is 1 request per minute (`portfolio-rate-limit.get_starbase_risk_limits`). The response includes `Retry-After` (seconds until the next one-minute window).
- `500`: Internal server error while resolving position limits.

## Changes

- **2026-09-24** `35d826cd9f72`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/deribit/apis/starbase-rest-api/changes/api/v2/private/get_starbase_risk_limits/get.md)

---

[API](https://skmtc.dev/deribit/apis/starbase-rest-api.md) - [All operations](https://skmtc.dev/deribit/apis/starbase-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/deribit/apis/starbase-rest-api/revisions/35d826cd9f72?raw)