GET /private/buy – Deribit API

Trading

Matching Engine

Private

Changed on Oct 29, 2026

Places a buy order for an instrument. Supports various order types including limit, market, stop, and advanced order types (stop-limit, take-profit, take-profit-limit, trailing-stop, etc.).

You can specify order parameters such as price, quantity, time-in-force, post-only, reduce-only, and trigger conditions. Orders can be labeled for easier management and tracking.

Note: For spot orders routed to Coinbase Exchange, fills come back asynchronously. It is recommended to receive fills from the user.trades channel.

📖 Related Articles:

Scope: trade:read_write

Try in API console

get/private/buy

Request

Base URL
https://test.deribit.com/api/v2
URL
https://test.deribit.com/api/v2/private/buy
Auth
none declared

Query parameters

instrument_namestring required

Unique instrument identifier

Example:BTC-PERPETUAL

Instrument name

amountnumber

It represents the requested order size. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin. The amount is a mandatory parameter if contracts parameter is missing. If both contracts and amount parameter are passed they must match each other otherwise error is returned.

contractsnumber

It represents the requested order size in contract units and can be passed instead of amount. The contracts is a mandatory parameter if amount parameter is missing. If both contracts and amount parameter are passed they must match each other otherwise error is returned.

The order type, default: "limit"

stop_limit, stop_market, take_limit, take_market, and trailing_stop (trigger/algo order types) are not supported for option and option_combo instruments.

For spot trading routed to Coinbase Exchange, only "market", "limit" and "stop_limit" orders are supported. Other order types will be rejected.

labelstring

user defined label for the order (maximum 64 characters)

pricenumber

Order price in the instrument's price units (quote currency for futures and spot). Required for limit, stop_limit and take_limit; not used for market-like types. When adding an order with advanced=usd, the field price should be the option price value in USD. When adding an order with advanced=implv, the field price should be a value of implied volatility in percentages. For example, price=100, means implied volatility of 100%

time_in_force'good_til_cancelled' | 'good_til_day' | 'fill_or_kill' | 'immediate_or_cancel'

Specifies how long the order remains in effect. Default `"good_til_cancelled"` <ul> <li>`"good_til_cancelled"` - unfilled order remains in order book until cancelled</li> <li>`"good_til_day"` - unfilled order remains in order book till the end of the trading session</li> <li>`"fill_or_kill"` - execute a transaction immediately and completely or not at all</li> <li>`"immediate_or_cancel"` - execute a transaction immediately, and any portion of the order that cannot be immediately filled is cancelled</li> </ul> For spot trading, only `"good_til_cancelled"`, `"immediate_or_cancel"` and `"fill_or_kill"` are supported. `"good_til_day"` is not supported and will be rejected.

display_amountnumber

Initial visible amount for an iceberg order. Must meet the instrument's minimum iceberg amount and amount step, not exceed total amount, and satisfy the instrument's maximum total-to-display ratio.

Iceberg orders are not supported for option, future_combo, and option_combo instruments.

post_onlyboolean

If true, the order is considered post-only. If the new price would cause the order to be filled immediately (as taker), the price will be changed to be just below the spread. Only valid for non-market, non-advanced orders with time_in_force=good_til_cancelled or good_til_day. For spot trading routed to Coinbase Exchange, the price is never adjusted: `"post_only"` must be combined with `"reject_post_only"` set to true, and the order is rejected if it would be matched instantly.

reject_post_onlyboolean

If an order is considered post-only and this field is set to true then the order is put to the order book unmodified or the request is rejected. Only valid in combination with `"post_only"` set to true For spot trading routed to Coinbase Exchange, this must be set to true whenever `"post_only"` is true; otherwise the request is rejected with `post_only_not_allowed`.

reduce_onlyboolean

If true, the order is considered reduce-only which is intended to only reduce a current position

trigger_pricenumber

Trigger price, required for trigger orders only (Stop-loss or Take-profit orders)

trigger_offsetnumber

Positive deviation from the price peak at which the order triggers; required for trailing_stop.

trigger'index_price' | 'mark_price' | 'last_price'

Trigger type (only for trigger orders). Allowed values: "index_price", "mark_price", "last_price".

Defines the trigger type. Required for `"Stop-Loss"`, `"Take-Profit"` and `"Trailing"` trigger orders For stop-limit orders routed to Coinbase Exchange, only `"last_price"` is allowed.

advanced'usd' | 'implv'

advanced type: "usd" or "implv" (Only for options; field is omitted if not applicable).

Advanced option order type. (Only for options. Advanced USD orders are not supported for linear options.)

mmpboolean

Order MMP flag, only for order_type 'limit'

valid_untilinteger

Timestamp, when provided server will start processing request in Matching Engine only before given timestamp, in other cases timed_out error will be responded. Remember that the given timestamp should be consistent with the server's time, use <a href='#public-get_time'>/public/time</a> method to obtain current server time.

linked_order_type'one_triggers_other' | 'one_cancels_other' | 'one_triggers_one_cancels_other'

The type of the linked order. <ul> <li>`"one_triggers_other"` - Execution of primary order triggers the placement of one or more secondary orders.</li> <li>`"one_cancels_other"` - The execution of one order in a pair automatically cancels the other, typically used to set a stop-loss and take-profit simultaneously.</li> <li>`"one_triggers_one_cancels_other"` - The execution of a primary order triggers two secondary orders (a stop-loss and take-profit pair), where the execution of one secondary order cancels the other.</li> </ul>

trigger_fill_condition'first_hit' | 'complete_fill' | 'incremental'

The fill condition of the linked order (Only for linked order types), default: `first_hit`. <ul> <li>`"first_hit"` - any execution of the primary order will fully cancel/place all secondary orders.</li> <li>`"complete_fill"` - a complete execution (meaning the primary order no longer exists) will cancel/place the secondary orders.</li> <li>`"incremental"` - any fill of the primary order will cause proportional partial cancellation/placement of the secondary order. The amount that will be subtracted/added to the secondary order will be rounded down to the contract size.</li> </ul>

amountnumber

Required. The secondary order size. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin.

direction'buy' | 'sell'

Required. Direction of the secondary order.

The order type, default: "limit"

labelstring

User defined label for the order (maximum 64 characters).

pricenumber

The order price in base currency. Required for limit and stop_limit orders.

reduce_onlyboolean

If true, the order is considered reduce-only which is intended to only reduce a current position.

time_in_force'good_til_cancelled' | 'good_til_day' | 'fill_or_kill' | 'immediate_or_cancel'

Specifies how long the order remains in effect. Default "good_til_cancelled".

post_onlyboolean

If true, the order is considered post-only. If the new price would cause the order to be filled immediately (as taker), the price will be changed to be just below or above the spread (according to the direction of the order).

reject_post_onlyboolean

If an order is considered post-only and this field is set to true then the order is put to the order book unmodified or the request is rejected.

trigger_pricenumber

Trigger price. Required for trigger orders (stop-loss or take-profit orders).

trigger_offsetnumber

The maximum deviation from the price peak beyond which the order will be triggered. Used for trailing stop orders.

trigger'index_price' | 'mark_price' | 'last_price'

Defines the trigger type. Required for stop-loss, take-profit, and trailing stop orders.

List of secondary orders. Each requires positive amount and direction. Non-market types (including take_limit) require price. Stop/take orders require trigger and trigger_price; trailing-stop orders require trigger and positive trigger_offset.

Response

Success response

jsonrpc'2.0' required

The JSON-RPC version (2.0)

idinteger

The id that was sent in the request

Example response

{
  "result": {
    "order": {
      "order_id": "ETH-100234",
      "instrument_name": "BTC-PERPETUAL",
      "creation_timestamp": 1536569522277,
      "last_update_timestamp": 1536569522277,
      "starbase_last_update_timestamp": 1536569522277000000,
      "block_trade": true,
      "trigger_order_id": "SLIB-370",
      "combo_order_id": "103148386169",
      "starbase_order_id": 103148386170,
      "app_name": "Example Application",
      "mmp_cancelled": true,
      "oto_order_ids": [
        "ETH-100234"
      ],
      "primary_order_id": "ETH-100234"
    },
    "trades": [
      {
        "instrument_name": "BTC-PERPETUAL",
        "timestamp": 1517329113791,
        "starbase_timestamp": 1536569522277000000,
        "starbase_order_id": 103148386170,
        "block_trade_id": "154",
        "block_trade_leg_count": 3
      }
    ],
    "oco_orders": [
      {
        "order_id": "ETH-100234",
        "instrument_name": "BTC-PERPETUAL",
        "creation_timestamp": 1536569522277,
        "last_update_timestamp": 1536569522277,
        "starbase_last_update_timestamp": 1536569522277000000,
        "block_trade": true,
        "trigger_order_id": "SLIB-370",
        "combo_order_id": "103148386169",
        "starbase_order_id": 103148386170,
        "app_name": "Example Application",
        "mmp_cancelled": true,
        "oto_order_ids": [
          "ETH-100234"
        ],
        "primary_order_id": "ETH-100234"
      }
    ]
  }
}

Changes

Oct 29, 202682518876f388 Revision changes
- breaking
  for the query request parameter post_only, default value was changed from true to false
- breaking
  for the query request parameter display_amount, default value 1 was removed
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property / became optional for the status
- breaking
  the /// response's property type changed from string to boolean for status
- breaking
  the /// response's property type changed from string to boolean for status
- info
  added the optional property / to the response with the status
Aug 4, 202678a0783dbfcc Revision changes
- info
  added the optional property /// to the response with the status

Operation history (3 revisions)

Request

Query parameters

Response 200OK

Example response

Changes

Response