private/create_block_rfq

Taker method

Creates a new Block RFQ. Use private/get_block_rfqs to retrieve Block RFQ information.

Block RFQ pre-allocation: The taker can split the total amount between different (sub)accounts using the trade_allocations parameter. The taker can also allocate to himself. Each allocation must specify either user_id (for direct allocation) or client_info object (for broker allocation), and amount.

📖 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/create_block_rfq \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "private/create_block_rfq",
  "params": {
    "legs": [
      {
        "instrument_name": "BTC-15NOV24",
        "amount": 20000,
        "direction": "sell"
      }
    ],
    "hedge": {
      "amount": 10,
      "direction": "buy",
      "price": 70000,
      "instrument_name": "BTC-PERPETUAL"
    },
    "label": "example",
    "makers": [
      "MAKER1"
    ]
  }
}
'

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "label": "example",
    "state": "created",
    "amount": 20000,
    "role": "taker",
    "bids": [],
    "asks": [],
    "combo_id": "BTC-15NOV24",
    "legs": [
      {
        "direction": "sell",
        "instrument_name": "BTC-15NOV24",
        "ratio": 1
      }
    ],
    "creation_timestamp": 1731062187555,
    "block_rfq_id": 507,
    "expiration_timestamp": 1731062487555,
    "hedge": {
      "amount": 10,
      "direction": "buy",
      "price": 70000,
      "instrument_name": "BTC-PERPETUAL"
    },
    "makers": [
      "MAKER1"
    ]
  }
}

Query Parameters

legs · string · required

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

trade_allocations · string

List of allocations for Block RFQ pre-allocation. Allows to split amount between different (sub)accounts or broker clients. Each allocation must specify either user_id (for direct allocation) or client_info object (for broker allocation), and amount. JSON string containing array of objects

hedge · string

Hedge leg of the Block RFQ. There is only one hedge leg allowed per Block RFQ JSON string containing: object data

label · string

User defined label for the Block RFQ (maximum 64 characters)

makers · string[]

List of targeted Block RFQ makers. Only those makers will be notified about created Block RFQ. If the list is empty, all available makers will be targeted.

disclosed · boolean

Determines whether the RFQ is non-anonymous, revealing both taker and maker aliases. It can be set to false (anonymous mode) only when at least 5 makers are targeted. Default value is true.

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