Skip to main content
cURL
curl --request GET \
  --url https://test.deribit.com/api/v2/private/add_block_rfq_quote \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "private/add_block_rfq_quote",
  "params": {
    "label": "example_quote",
    "block_rfq_id": 3,
    "amount": 10000,
    "direction": "buy",
    "legs": [
      {
        "instrument_name": "BTC-15NOV24",
        "price": 69600,
        "ratio": "1",
        "direction": "buy"
      }
    ],
    "hedge": {
      "amount": 10,
      "direction": "buy",
      "price": 70000,
      "instrument_name": "BTC-PERPETUAL"
    },
    "execution_instruction": "any_part_of",
    "expires_at": 1745312540321
  }
}
'
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "label": "example_quote",
    "amount": 10000,
    "direction": "buy",
    "price": 69600,
    "legs": [
      {
        "direction": "buy",
        "price": 69600,
        "instrument_name": "BTC-15NOV24",
        "ratio": 1
      }
    ],
    "creation_timestamp": 1731076586371,
    "block_rfq_id": 3,
    "replaced": false,
    "filled_amount": 0,
    "hedge": {
      "amount": 10,
      "direction": "buy",
      "price": 70000,
      "instrument_name": "BTC-PERPETUAL"
    },
    "last_update_timestamp": 1731076586371,
    "block_rfq_quote_id": 8,
    "quote_state": "open"
  }
}

Query Parameters

​
label
string

User defined label for the Block RFQ quote (maximum 64 characters). Used to identify quotes of a selected Block RFQ

​
block_rfq_id
integer
required

ID of the Block RFQ

​
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 trade from the maker perspective Direction: buy, or sell

Available options:
buy,
sell
​
legs
string
required

List of legs used for Block RFQ quote 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

​
execution_instruction
enum<string>

Execution instruction of the quote. Default - any_part_of

  • "all_or_none (AON)" - The quote can only be filled entirely or not at all, ensuring that its amount matches the amount specified in the Block RFQ. Additionally, 'all_or_none' quotes have priority over 'any_part_of' quotes at the same price level.
  • "any_part_of (APO)" - The quote can be filled either partially or fully, with the filled amount potentially being less than the Block RFQ amount.
Available options:
all_or_none,
any_part_of
​
price
number

Aggregated price used for quoting future spreads.

​
expires_at
integer

The timestamp when the quote expires (milliseconds since the Unix epoch)

Example:

1745312540321

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