Skip to main content
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"
  }
}
'
{
  "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
id
integer

The id that was sent in the request