Sign in

v2

OpenAPI 3.0.02026-07-311824171.4 MB
Block RFQ
Private

Maker method

Adds a quote to an existing Block RFQ. To calculate individual leg prices, use private/get_leg_prices.

Use private/get_block_rfqs to retrieve Block RFQ information, or private/edit_block_rfq_quote to modify an existing quote.

📖 Related Article: Deribit Block RFQ API walkthrough

Scope: block_rfq:read_write

Try in API console

get/private/add_block_rfq_quote

Query parameters

labelstring

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

block_rfq_idinteger required

ID of the Block RFQ

amountnumber required

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.

This value multiplied by the ratio of a leg gives trade size on that leg.

direction'buy' | 'sell' required

Direction: buy, or sell

Direction of trade from the maker perspective

instrument_namestring

Unique instrument identifier

pricenumber

Price for trade

ratiointeger

Ratio of amount between legs

direction'buy' | 'sell'

Direction: buy, or sell

List of legs used for Block RFQ quote

[
  {
    "instrument_name": "BTC-PERPETUAL"
  }
]
hedgestring

JSON string containing: instrument_name, direction, price, amount

Hedge leg of the Block RFQ. There is only one hedge leg allowed per Block RFQ

execution_instruction'all_or_none' | 'any_part_of'
<p>Execution instruction of the quote. Default - `any_part_of`</p> <ul> <li>`"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.</li> <li>`"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.</li> </ul>
pricenumber

Aggregated price used for quoting future spreads.

expires_atinteger
Example:1745312540321

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

Response

Success response

jsonrpc'2.0' required

The JSON-RPC version (2.0)

idinteger

The id that was sent in the request

Example response

{
  "result": {
    "creation_timestamp": 1536569522277,
    "last_update_timestamp": 1536569522277,
    "legs": [
      {
        "instrument_name": "BTC-PERPETUAL"
      }
    ],
    "hedge": {
      "instrument_name": "BTC-PERPETUAL"
    },
    "app_name": "Example Application"
  }
}