public/get_block_rfq_trades

Returns a list of recent Block RFQ trades. Can be optionally filtered by currency.

This is a public method that provides market data about completed Block RFQ trades. For private Block RFQ information, use private/get_block_rfqs.

📖 Related Article: Deribit Block RFQ API walkthrough

Try in API console

cURL

cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/public/get_block_rfq_trades \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "public/get_block_rfq_trades",
  "params": {
    "currency": "BTC"
  }
}
'

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "continuation": "1739739009234:6570",
    "block_rfqs": [
      {
        "id": 6611,
        "timestamp": 1739803305362,
        "combo_id": "BTC-CS-28FEB25-100000_106000",
        "legs": [
          {
            "price": 0.1,
            "direction": "buy",
            "instrument_name": "BTC-28FEB25-100000-C",
            "ratio": 1
          },
          {
            "price": 0.05,
            "direction": "sell",
            "instrument_name": "BTC-28FEB25-106000-C",
            "ratio": 1
          }
        ],
        "amount": 12.5,
        "direction": "sell",
        "mark_price": 0.010356754,
        "trades": [
          {
            "price": 0.05,
            "amount": 12.5,
            "direction": "sell",
            "hedge_amount": 50
          }
        ],
        "hedge": {
          "price": 96000,
          "amount": 50,
          "direction": "sell",
          "instrument_name": "BTC-PERPETUAL"
        },
        "index_prices": {
          "btc_usd": 96000,
          "btc_usdc": 95950
        }
      },
      {
        "id": 6600,
        "timestamp": 1739774397766,
        "combo_id": "BTC-CS-28FEB25-100000_106000",
        "legs": [
          {
            "price": 0.1,
            "direction": "buy",
            "instrument_name": "BTC-28FEB25-100000-C",
            "ratio": 1
          },
          {
            "price": 0.05,
            "direction": "sell",
            "instrument_name": "BTC-28FEB25-106000-C",
            "ratio": 1
          }
        ],
        "amount": 12.5,
        "direction": "sell",
        "mark_price": 0.007458089,
        "trades": [
          {
            "price": 0.05,
            "amount": 12.5,
            "direction": "sell",
            "hedge_amount": 50
          }
        ],
        "hedge": {
          "price": 96000,
          "amount": 50,
          "direction": "sell",
          "instrument_name": "BTC-PERPETUAL"
        },
        "index_prices": {
          "btc_usd": 96000,
          "btc_usdc": 95950
        }
      },
      {
        "id": 6579,
        "timestamp": 1739743922308,
        "combo_id": "BTC-CS-17FEB25-89000_90000",
        "legs": [
          {
            "price": 0.08,
            "direction": "buy",
            "instrument_name": "BTC-17FEB25-89000-C",
            "ratio": 1
          },
          {
            "price": 0.075,
            "direction": "sell",
            "instrument_name": "BTC-17FEB25-90000-C",
            "ratio": 1
          }
        ],
        "amount": 12.5,
        "direction": "sell",
        "mark_price": 0.010314468,
        "trades": [
          {
            "price": 0.005,
            "amount": 12.5,
            "direction": "sell"
          }
        ]
      }
    ]
  }
}

Query Parameters

currency · enum<string> · required

The currency symbol or "any" for all Currency name or "any" if don't care

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

continuation · string

Continuation token for pagination. Consists of timestamp and block_rfq_id.

Example:

"1738050297271:103"

count · integer

Count of Block RFQs returned, maximum - 1000

Required range: 1 <= x <= 1000

Response

200 - application/json

Success response

jsonrpc · enum<string> · required

The JSON-RPC version (2.0)

Available options: 2.0

result · object · required

Hide child attributes

result. block_rfqs · object[]

Hide child attributes

result.block_rfqs. id · integer

ID of the Block RFQ

result.block_rfqs. timestamp · integer

The timestamp of the trade (milliseconds since the UNIX epoch)

Example:

1517329113791

result.block_rfqs. direction · enum<string>

Trade direction of the taker

Available options: buy, sell

result.block_rfqs. amount · number

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

result.block_rfqs. mark_price · number

Mark Price at the moment of trade

result.block_rfqs. legs · object[]

Hide child attributes

result.block_rfqs.legs. ratio · integer

Ratio of amount between legs

result.block_rfqs.legs. instrument_name · string

Unique instrument identifier

Example:

"BTC-PERPETUAL"

result.block_rfqs.legs. direction · enum<string>

Direction: buy, or sell

Available options: buy, sell

result.block_rfqs.legs. price · number

Price for a leg

result.block_rfqs. combo_id · string

Unique combo identifier

Example:

"BTC-FS-31DEC21-PERP"

result.block_rfqs. hedge · object

Hide child attributes

result.block_rfqs.hedge. amount · 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.

result.block_rfqs.hedge. instrument_name · string

Unique instrument identifier

Example:

"BTC-PERPETUAL"

result.block_rfqs.hedge. direction · enum<string>

Direction: buy, or sell

Available options: buy, sell

result.block_rfqs.hedge. price · number

Price for a hedge leg

result.block_rfqs. index_prices · object

A map of index prices for the underlying instrument(s) at the time of trade execution, where keys are price index names and values are prices.

result.block_rfqs. trades · object[]

Hide child attributes

result.block_rfqs.trades. direction · enum<string>

Direction: buy, or sell

Available options: buy, sell

result.block_rfqs.trades. price · number

Price in base currency

result.block_rfqs.trades. amount · 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.

result.block_rfqs.trades. hedge_amount · 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.

result. continuation · string

Continuation token for pagination. NULL when no continuation. Consists of timestamp and block_rfq_id.

Example:

"1738050297271:103"

id · integer

The id that was sent in the request