private/get_block_rfqs

Returns a list of Block RFQs that were either created by the user or assigned to them as a maker, sorted in descending order.

trades and mark_price are only visible for the filled Block RFQ. When a block_rfq_id is specified, only that particular Block RFQ will be returned. If called by a taker, response will additionally include makers list and label if previously provided. If called by the maker, the trades will include the maker’s alias, but only for trades in which this maker participated. Can be optionally filtered by currency.

Use private/get_block_rfq_quotes to retrieve quotes for Block RFQs.

📖 Related Article: Deribit Block RFQ API walkthrough

Scope: block_rfq:read

Try in API console

cURL

cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/private/get_block_rfqs \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "private/get_block_rfqs",
  "params": {
    "count": 20,
    "state": "open",
    "role": "maker"
  }
}
'

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "continuation": null,
    "block_rfqs": [
      {
        "state": "open",
        "amount": 40000,
        "role": "maker",
        "combo_id": "BTC-15NOV24",
        "legs": [
          {
            "direction": "sell",
            "instrument_name": "BTC-15NOV24",
            "ratio": 1
          }
        ],
        "creation_timestamp": 1731062457741,
        "block_rfq_id": 508,
        "expiration_timestamp": 1731062757741,
        "hedge": {
          "amount": 10,
          "direction": "buy",
          "price": 70000,
          "instrument_name": "BTC-PERPETUAL"
        },
        "taker_rating": "1-2"
      }
    ]
  }
}

Query Parameters

count · integer

Count of Block RFQs returned, maximum - 1000

Required range: 1 <= x <= 1000

state · enum<string>

State of Block RFQ

Available options: open, filled, traded, cancelled, expired, closed

role · enum<string>

Role of the user in Block RFQ. When the any role is selected, the method returns all Block RFQs in which the user has participated, either as the taker or as a maker

Available options: any, taker, maker

continuation · integer

The continuation parameter specifies the starting point for fetching historical Block RFQs. When provided, the endpoint returns Block RFQs, starting from the specified ID and continuing backward (e.g., if continuation is 50, results will include Block RFQs of ID 49, 48, etc.)

block_rfq_id · integer

ID of the Block RFQ

currency · enum<string>

The currency symbol Currency, i.e "BTC", "ETH", "USDC"

Available options: BTC, ETH, USDC, USDT, any

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