{
"jsonrpc": "2.0",
"method": "public/subscribe",
"id": 42,
"params": {
"channels": [
"block_rfq.maker.(currency)"
]
}
}{
"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.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
Trade cross-posting: When a Block RFQ is filled, the resulting trades are also delivered through the user.trades.{instrument_name}.{interval} and user.trades.{kind}.{currency}.{interval} channels. Those notifications include block_rfq_id, block_trade_id, and — for the maker side — block_rfq_quote_id.
📖 Related Article: Deribit Block RFQ API walkthrough
{
"jsonrpc": "2.0",
"method": "public/subscribe",
"id": 42,
"params": {
"channels": [
"block_rfq.maker.(currency)"
]
}
}{
"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 code or any for all
Allowed values: BTC, ETH, USDC, USDT, EURR, any
BTC, ETH, USDC, USDT, EURR, anyClient sends subscription request to subscribe to notification channel. Please refer to Notification page for more information.
Server sends subscription notification data
The timestamp when Block RFQ was created (milliseconds since the Unix epoch)
The timestamp when the Block RFQ will expire (milliseconds since the UNIX epoch)
ID of the Block RFQ
Role of the user in Block RFQ
taker, makerState of the Block RFQ
open, filled, cancelled, expiredRating of the taker
This value multiplied by the ratio of a leg gives trade size on that leg.
Minimum amount for trading
Ratio of amount between legs
Unique instrument identifier
Direction: buy, or sell
buy, sellIt 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.
Unique instrument identifier
Direction: buy, or sell
buy, sellPrice for a hedge leg
Unique combo identifier
Indicates whether the RFQ was created as non-anonymous, meaning taker and maker aliases are visible to counterparties.
Taker alias. Present only when disclosed is true.
Indicates whether the RFQ is included in the taker's rating calculation. Present only for closed RFQs created by the requesting taker.
Direction: buy, or sell
buy, sellPrice in base currency
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.
Alias of the maker (optional)
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.
Was this page helpful?