private/accept_block_rfq

Taker method

Allows Block RFQ taker to accept a quote by sending a single crossing price. The order can be either filled immediately (fill_or_kill) or remain active until cancelled (good_til_cancelled).

Note: After Block RFQ creation, a grace period of 5 seconds begins, during which the taker cannot see quotes or trade the Block RFQ.

Use private/get_block_rfqs to retrieve Block RFQ information, or private/cancel_block_rfq to cancel a Block RFQ.

📖 Related Article: Deribit Block RFQ API walkthrough

Scope: block_rfq:read_write

Try in API console

cURL

cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/private/accept_block_rfq \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "private/accept_block_rfq",
  "params": {
    "block_rfq_id": 1,
    "legs": [
      {
        "instrument_name": "BTC-8NOV24-70000-C",
        "ratio": 1,
        "direction": "buy"
      },
      {
        "instrument_name": "BTC-8NOV24-72000-C",
        "ratio": 1,
        "direction": "sell"
      }
    ],
    "price": 0.01,
    "direction": "buy",
    "amount": 100,
    "time_in_force": "fill_or_kill"
  }
}
'

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "block_trades": [
      {
        "id": "BLOCK-423",
        "timestamp": 1730798381504,
        "trades": [
          {
            "timestamp": 1730798381502,
            "state": "filled",
            "fee": 1.5e-7,
            "amount": 100,
            "direction": "buy",
            "price": 69696.8,
            "index_price": 70000,
            "profit_loss": 0,
            "instrument_name": "BTC-8NOV24-70000-C",
            "trade_seq": 113,
            "mark_price": 0.03,
            "order_id": "2899",
            "matching_id": null,
            "tick_direction": 2,
            "combo_id": "BTC-CS-8NOV24-70000_72000",
            "block_rfq_id": 1,
            "api": true,
            "contracts": 100,
            "post_only": false,
            "block_trade_id": "BLOCK-423",
            "trade_id": "771",
            "order_type": "limit",
            "mmp": false,
            "risk_reducing": false,
            "reduce_only": false,
            "block_trade_leg_count": 2,
            "self_trade": false,
            "fee_currency": "BTC",
            "liquidity": "T"
          },
          {
            "timestamp": 1730798381502,
            "state": "filled",
            "fee": 1.5e-7,
            "amount": 100,
            "direction": "sell",
            "price": 69677.4,
            "index_price": 70000,
            "profit_loss": 0,
            "instrument_name": "BTC-8NOV24-72000-C",
            "trade_seq": 113,
            "mark_price": 0.02,
            "order_id": "2900",
            "matching_id": null,
            "tick_direction": 2,
            "combo_id": "BTC-CS-8NOV24-70000_72000",
            "block_rfq_id": 1,
            "api": true,
            "contracts": 100,
            "post_only": false,
            "block_trade_id": "BLOCK-423",
            "trade_id": "772",
            "order_type": "limit",
            "mmp": false,
            "risk_reducing": false,
            "reduce_only": false,
            "block_trade_leg_count": 2,
            "self_trade": false,
            "fee_currency": "BTC",
            "liquidity": "T"
          }
        ]
      }
    ]
  }
}

Query Parameters

block_rfq_id · integer · required

ID of the Block RFQ

price · number · required

Maximum acceptable price for execution

amount · number · required

This value multiplied by the ratio of a leg gives trade size on that leg. 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.

direction · enum<string> · required

Direction of the trade from the taker perspective Direction: buy, or sell

Available options: buy, sell

hedge · string

Hedge leg of the Block RFQ. There is only one hedge leg allowed per Block RFQ JSON string containing: instrument_name, direction, price, amount

legs · object[] · required

List of legs used to trade Block RFQ

Hide child attributes

legs. instrument_name · string

Instrument name

Example:

"BTC-PERPETUAL"

legs. direction · enum<string>

Direction of selected leg. Must match the direction of the corresponding leg in the Block RFQ

Available options: buy, sell

legs. ratio · integer

Ratio of amount between legs

time_in_force · enum<string> · required

Specifies how long the order should remain active

Available options: fill_or_kill, good_til_cancelled

Example:

"fill_or_kill"

Response

200 - application/json

Success response

jsonrpc · enum<string> · required

The JSON-RPC version (2.0)

Available options: 2.0

result · object · required

Hide child attributes

result. trade_trigger · object · required

Hide child attributes

result.trade_trigger. state · enum<string>

Available options: untriggered

result.trade_trigger. price · number

result.trade_trigger. direction · enum<string>

Available options: buy, sell

result. block_trades · object[] · required

Hide child attributes

result.block_trades. id · string · required

Block trade id

Example:

"154"

result.block_trades. timestamp · integer · required

The timestamp (milliseconds since the Unix epoch)

Example:

1536569522277

result.block_trades. trades · object[] · required

Hide child attributes

result.block_trades.trades. trade_id · string · required

Unique (per currency) trade identifier

result.block_trades.trades. trade_seq · integer · required

The sequence number of the trade within instrument

result.block_trades.trades. instrument_name · string · required

Unique instrument identifier

Example:

"BTC-PERPETUAL"

result.block_trades.trades. timestamp · integer · required

The timestamp of the trade (milliseconds since the UNIX epoch)

Example:

1517329113791

result.block_trades.trades. order_id · string · required

Id of the user order (maker or taker), i.e. subscriber's order id that took part in the trade

result.block_trades.trades. matching_id · string · required

Always null

result.block_trades.trades. direction · enum<string> · required

Trade direction of the taker

Available options: buy, sell

result.block_trades.trades. tick_direction · enum<integer> · required

Direction of the "tick" (0 = Plus Tick, 1 = Zero-Plus Tick, 2 = Minus Tick, 3 = Zero-Minus Tick).

Available options: 0, 1, 2, 3

result.block_trades.trades. index_price · number · required

Index Price at the moment of trade

result.block_trades.trades. price · number · required

The price of the trade

result.block_trades.trades. amount · number · required

Trade amount. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin.

result.block_trades.trades. fee · number · required

User's fee in units of the specified fee_currency

result.block_trades.trades. fee_currency · enum<string> · required

Currency, i.e "BTC", "ETH", "USDC"

Available options: BTC, ETH, USDC, USDT, EURR

result.block_trades.trades. state · enum<string> · required

Order state: "open", "filled", "rejected", "cancelled", "untriggered" or "archive" (if order was archived)

Available options: open, filled, rejected, cancelled, untriggered, archive

result.block_trades.trades. mark_price · number · required

Mark Price at the moment of trade

result.block_trades.trades. order_type · enum<string>

Order type: "limit, "market", or "liquidation"

Available options: limit, market, liquidation

result.block_trades.trades. advanced · enum<string>

Advanced type of user order: "usd" or "implv" (only for options; omitted if not applicable)

Available options: usd, implv

result.block_trades.trades. contracts · number

Trade size in contract units (optional, may be absent in historical trades)

result.block_trades.trades. iv · number

Option implied volatility for the price (Option only)

result.block_trades.trades. underlying_price · number

Underlying price for implied volatility calculations (Options only)

result.block_trades.trades. liquidation · enum<string>

Optional field (only for trades caused by liquidation): "M" when maker side of trade was under liquidation, "T" when taker side was under liquidation, "MT" when both sides of trade were under liquidation

Available options: M, T, MT

result.block_trades.trades. liquidity · enum<string>

Describes what was role of users order: "M" when it was maker order, "T" when it was taker order

Available options: M, T

result.block_trades.trades. label · string

User defined label (presented only when previously set for order by user)

result.block_trades.trades. block_trade_id · string

Block trade id - when trade was part of a block trade

Example:

"154"

result.block_trades.trades. block_rfq_id · integer

ID of the Block RFQ - when trade was part of the Block RFQ

result.block_trades.trades. block_rfq_quote_id · integer

ID of the Block RFQ quote - when trade was part of the Block RFQ

result.block_trades.trades. reduce_only · string

true if user order is reduce-only

result.block_trades.trades. post_only · string

true if user order is post-only

result.block_trades.trades. mmp · boolean

true if user order is MMP

result.block_trades.trades. risk_reducing · boolean

true if user order is marked by the platform as a risk reducing order (can apply only to orders placed by PM users)

result.block_trades.trades. api · boolean

true if user order was created with API

result.block_trades.trades. profit_loss · number

Profit and loss in base currency.

result.block_trades.trades. legs · array

Optional field containing leg trades if trade is a combo trade (present when querying for only combo trades and in combo_trades events)

result.block_trades.trades. combo_id · string

Optional field containing combo instrument name if the trade is a combo trade

result.block_trades.trades. combo_trade_id · number

Optional field containing combo trade identifier if the trade is a combo trade

result.block_trades.trades. quote_set_id · string

QuoteSet of the user order (optional, present only for orders placed with private/mass_quote)

result.block_trades.trades. quote_id · string

QuoteID of the user order (optional, present only for orders placed with private/mass_quote)

result.block_trades.trades. trade_allocations · object[]

List of allocations for Block RFQ pre-allocation. Each allocation specifies user_id, amount, and fee for the allocated part of the trade. For broker client allocations, a client_info object will be included.

Hide child attributes

result.block_trades.trades.trade_allocations. amount · number · required

Amount allocated to this user.

result.block_trades.trades.trade_allocations. fee · number · required

Fee for the allocated part of the trade.

result.block_trades.trades.trade_allocations. user_id · integer

User ID to which part of the trade is allocated. For brokers the User ID is obstructed.

result.block_trades.trades.trade_allocations. client_info · object

Optional client allocation info for brokers.

Hide child attributes

result.block_trades.trades.trade_allocations.client_info. client_id · integer

ID of a client; available to broker. Represents a group of users under a common name.

result.block_trades.trades.trade_allocations.client_info. client_link_id · integer

ID assigned to a single user in a client; available to broker.

result.block_trades.trades.trade_allocations.client_info. name · string

Name of the linked user within the client; available to broker.

result.block_trades. app_name · string

The name of the application that executed the block trade on behalf of the user (optional).

Example:

"Example Application"

result.block_trades. broker_code · string

Broker code associated with the broker block trade.

Example:

"2krM7sJsx"

result.block_trades. broker_name · string

Name of the broker associated with the block trade.

Example:

"Test Broker"

id · integer

The id that was sent in the request