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: object data

legs · string · required

List of legs used to trade Block RFQ JSON string containing array of objects

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

Show child attributes

id · integer

The id that was sent in the request