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.

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.

Get Open Orders

cURL

curl --request GET \
  --url https://{environment}.deribit.com/api/v2/private/get_open_orders \
  --header 'Authorization: Bearer <token>'

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "order_id": "1cc1c718-49e0-4ea5-8902-f3f22968c350",
      "instrument_name": "TREE-USD",
      "side": "sell",
      "price": 0.0717,
      "amount": 83698,
      "filled_amount": 0,
      "average_price": 0,
      "order_state": "open",
      "order_type": "limit",
      "creation_timestamp": 1778270370643,
      "last_update_timestamp": 1778270370643
    }
  ]
}

Authorizations

Authorization · string · header · required

API key passed as a Bearer token. The authenticated session determines the portfolio that operations are applied to.

Response

200

application/json

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

jsonrpc · enum<string> · required

The JSON-RPC version (2.0)

Available options: 2.0

result · object[] · required

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

Hide child attributes

result. order_id · string · required

Exchange-assigned order identifier (UUID-style string). Stable for the lifetime of the order.

Example:

"1cc1c718-49e0-4ea5-8902-f3f22968c350"

result. instrument_name · string · required

Human-readable instrument symbol the order was placed against.

Example:

"TREE-USD"

result. side · enum<string> · required

Order side.

Available options: buy, sell

result. price · number · required

Limit price of the order (in quote-currency units).

Example:

0.0717

result. amount · number · required

Original order quantity, in base-currency units.

Example:

83698

result. filled_amount · number · required

Quantity filled so far, in base-currency units.

Example:

0

result. order_state · enum<string> · required

Order state. Currently always open for entries returned by this endpoint, since only open orders are listed.

Available options: open

result. order_type · enum<string> · required

Order type, derived from the price field.

Available options: limit, market

result. average_price · number

Volume-weighted average fill price across all executions on this order. Zero if the order has no fills yet.

Example:

0

result. time_in_force · enum<string> | null

Time-in-force policy.

Available options: GTC, IOC, FOK, GTD

result. post_only · boolean | null

Whether the order was submitted as post-only.

result. reduce_only · boolean | null

Whether the order was submitted as reduce-only.

result. creation_timestamp · integer<int64>

Order submission time in milliseconds since the Unix epoch.

Example:

1778270370643

result. last_update_timestamp · integer<int64>

Time of the most recent change to the order, in milliseconds since the Unix epoch.

Example:

1778270370643

result. label · string | null

Client-supplied label for the order, if any.

result. api · boolean | null

Whether the order was placed via API.

result. max_show · number | null

Iceberg display quantity, if applicable.

result. profit_loss · number | null

Realised profit/loss attributable to this order, if any.

result. commission · number | null

Commission accrued by this order so far, if any.

id · integer

The id that was sent in the request