---
title: "Get Open Orders"
method: GET
path: "/api/v2/private/get_open_orders"
tags: ["Trading"]
---

# Get Open Orders

`GET /api/v2/private/get_open_orders`

Returns all currently-open orders belonging to the authenticated portfolio. Orders are returned regardless of instrument or order type; filtering by instrument kind and order type is not currently supported.

Each order includes `post_only`, `reject_post_only`, and `reduce_only` flags. `post_only` and `reject_post_only` correspond to the SBE `postOnly` and `postOnlyReject` bits and are mutually exclusive. `reduce_only` reflects per-order reduce-only from JSON-RPC or FIX (it cannot be set per order in SBE).

The portfolio is resolved from the authenticated session — there is no parameter to query another portfolio's orders. MMP-flagged orders are visible via this endpoint. Orders placed via Mass Quote (MassQuoteRequest) are not currently returned.

This endpoint is rate-limited per portfolio. Exceeding the limit returns HTTP 429.

## Response `200`

List of open orders for the authenticated portfolio. May be empty.

- GetOpenOrdersResponse
  - `jsonrpc` '2.0', required — The JSON-RPC version (2.0)
  - `id` integer — The id that was sent in the request
  - `result` Order[], required — Array of open orders for the authenticated portfolio. May be empty.
    - `order_id` string, required — Exchange-assigned order identifier (UUID-style string). Stable for the lifetime of the order.
    - `instrument_name` string, required — Human-readable instrument symbol the order was placed against.
    - `side` 'buy' | 'sell', required — Order side.
    - `price` number, required — Limit price of the order (in quote-currency units).
    - `amount` number, required — Original order quantity, in base-currency units.
    - `filled_amount` number, required — Quantity filled so far, in base-currency units.
    - `average_price` number — Volume-weighted average fill price across all executions on this order. Zero if the order has no fills yet.
    - `order_state` 'open', required — Order state. Currently always `open` for entries returned by this endpoint, since only open orders are listed.
    - `order_type` 'limit' | 'market', required — Order type, derived from the price field.
    - `time_in_force` 'GTC' | 'IOC' | 'FOK' | 'GTD', nullable — Time-in-force policy.
    - `post_only` boolean — Whether the order was submitted as post-only: if it would take liquidity, the price is amended to the best bid/ask instead of rejecting. Corresponds to SBE `postOnly`. Mutually exclusive with `reject_post_only`.
    - `reject_post_only` boolean — Whether the order was submitted as post-only reject: if it would take liquidity, the order is rejected rather than price-amended. Corresponds to SBE `postOnlyReject`. Mutually exclusive with `post_only`.
    - `reduce_only` boolean — Whether the order is reduce-only (intended only to reduce an existing position). Per-order reduce-only originates from JSON-RPC or FIX; it cannot be set per order in SBE.
    - `creation_timestamp` integer — Order submission time in milliseconds since the Unix epoch.
    - `last_update_timestamp` integer — Time of the most recent change to the order, in milliseconds since the Unix epoch.
    - `label` string, nullable — Client-supplied label for the order, if any.
    - `api` boolean, nullable — Whether the order was placed via API.
    - `max_show` number, nullable — Iceberg display quantity, if applicable.
    - `profit_loss` number, nullable — Realised profit/loss attributable to this order, if any.
    - `commission` number, nullable — Commission accrued by this order so far, if any.

## Other responses

- `401` — Missing or invalid `Authorization` header.
- `429` — Per-portfolio rate limit for this endpoint exceeded. Configured via `portfolio-rate-limit.get_open_orders`.
- `500` — Internal server error while reading the active-order set.

---

[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-service-production.skmtc.workers.dev/v1/apis/deribit/starbase-rest-api/revisions/2e8e1b6fb09d/schema)
