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

The id that was sent in the request