Messages

{
  "data": {
    "state": "open",
    "combo_id": "BTC-18NOV24-82000-C",
    "legs": [
      {
        "direction": "buy",
        "instrument_name": "BTC-18NOV24-82000-C",
        "ratio": 1
      }
    ],
    "amount": 25,
    "role": "maker",
    "expiration_timestamp": 1731664976443,
    "block_rfq_id": 722,
    "creation_timestamp": 1731664676443,
    "taker_rating": "1-2",
    "disclosed": true,
    "taker": "TAKER1"
  }
}

Block Rfq

block_rfq.maker.(currency)

Real-time notifications for Block RFQs (Request for Quotes) that are available for the subscribed maker to respond to.

This subscription notifies makers when new Block RFQs are created in the specified currency (or all currencies if any is used) that they can potentially quote on. Each notification includes:

RFQ identification: Unique Block RFQ ID, creation timestamp, and expiration timestamp
RFQ structure: Multi-leg trade structure with instrument names, directions (buy/sell), and ratios for each leg
Trade parameters: Total amount (multiplied by leg ratios determines trade size), minimum trade amount, and optional combo identifier
Hedge information: Optional hedge leg details including instrument, direction, amount, and price
RFQ state: Current state (open, filled, cancelled, or expired)
Counterparty information: Taker rating, taker alias (if disclosed), and disclosure status
Execution details: For filled RFQs, includes trade information with prices, amounts, directions, and maker aliases
Index prices: List of index prices for underlying instruments at trade execution time (for filled RFQs)
Rating information: Whether the RFQ is included in taker rating calculation (for closed RFQs)

Makers can subscribe to specific currencies (BTC, ETH, USDC, USDT) or use any to receive notifications for all supported currencies. This enables makers to monitor incoming RFQ opportunities and respond with competitive quotes in a timely manner.

Scope required: block_rfq:read

📖 Related Article: Deribit Block RFQ API walkthrough

Messages

{
  "data": {
    "state": "open",
    "combo_id": "BTC-18NOV24-82000-C",
    "legs": [
      {
        "direction": "buy",
        "instrument_name": "BTC-18NOV24-82000-C",
        "ratio": 1
      }
    ],
    "amount": 25,
    "role": "maker",
    "expiration_timestamp": 1731664976443,
    "block_rfq_id": 722,
    "creation_timestamp": 1731664676443,
    "taker_rating": "1-2",
    "disclosed": true,
    "taker": "TAKER1"
  }
}

currency

type:enum

required

Currency code or any for all

Allowed values: BTC, ETH, USDC, USDT, EURR, any

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

Subscription Request

type:object

Client sends subscription request to subscribe to notification channel. Please refer to Notification page for more information.

Subscription Notification Data

type:object

Server sends subscription notification data

data

type:object

required

creation_timestamp

type:integer

The timestamp when Block RFQ was created (milliseconds since the Unix epoch)

expiration_timestamp

type:integer

The timestamp when the Block RFQ will expire (milliseconds since the UNIX epoch)

block_rfq_id

type:integer

ID of the Block RFQ

role

type:enum

Role of the user in Block RFQ

Available options: taker, maker

state

type:enum

State of the Block RFQ

Available options: open, filled, cancelled, expired

taker_rating

type:string

Rating of the taker

amount

type:number

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

min_trade_amount

type:number

Minimum amount for trading

legs

type:object

ratio

type:integer

Ratio of amount between legs

instrument_name

type:string

Unique instrument identifier

direction

type:enum

Direction: buy, or sell

Available options: buy, sell

hedge

type:object

amount

type:integer

It represents the requested hedge leg size. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin.

instrument_name

type:string

Unique instrument identifier

direction

type:enum

Direction: buy, or sell

Available options: buy, sell

price

type:number

Price for a hedge leg

combo_id

type:string

Unique combo identifier

disclosed

type:boolean

Indicates whether the RFQ was created as non-anonymous, meaning taker and maker aliases are visible to counterparties.

taker

type:string

Taker alias. Present only when disclosed is true.

index_prices

type:object

included_in_taker_rating

type:boolean

Indicates whether the RFQ is included in the taker's rating calculation. Present only for closed RFQs created by the requesting taker.

trades

type:object

direction

type:enum

Direction: buy, or sell

Available options: buy, sell

price

type:number

Price in base currency

amount

type:number

Trade amount. For options, linear futures, linear perpetuals and spots the amount is denominated in the underlying base currency coin. The inverse perpetuals and inverse futures are denominated in USD units.

maker

type:string

Alias of the maker (optional)

hedge_amount

type:number

Amount of the hedge leg. For linear futures, linear perpetuals and spots the amount is denominated in the underlying base currency coin. The inverse perpetuals and inverse futures are denominated in USD units.

user.lock block_rfq.taker.(currency)

⌘I