block_rfq.taker.(currency) - Deribit API Documentation

Messages

{
  "data": {
    "label": "example",
    "state": "open",
    "amount": 10000,
    "role": "taker",
    "bids": [
      {
        "amount": 10000,
        "price": 291664.14,
        "makers": [
          "ANONYMOUS"
        ],
        "last_update_timestamp": 1740047910507,
        "execution_instruction": "any_part_of"
      }
    ],
    "asks": [],
    "combo_id": null,
    "legs": [
      {
        "direction": "buy",
        "instrument_name": "BTC-21FEB25",
        "ratio": 1
      },
      {
        "direction": "buy",
        "instrument_name": "BTC-28FEB25",
        "ratio": 1
      },
      {
        "direction": "buy",
        "instrument_name": "BTC-PERPETUAL",
        "ratio": 1
      }
    ],
    "min_trade_amount": 10,
    "makers": [
      "MAKER1",
      "MAKER2"
    ],
    "creation_timestamp": 1740047910438,
    "block_rfq_id": 321,
    "expiration_timestamp": 1740048210438,
    "taker_rating": "1-2",
    "disclosed": true,
    "taker": "TAKER1"
  }
}

Messages

{
  "data": {
    "label": "example",
    "state": "open",
    "amount": 10000,
    "role": "taker",
    "bids": [
      {
        "amount": 10000,
        "price": 291664.14,
        "makers": [
          "ANONYMOUS"
        ],
        "last_update_timestamp": 1740047910507,
        "execution_instruction": "any_part_of"
      }
    ],
    "asks": [],
    "combo_id": null,
    "legs": [
      {
        "direction": "buy",
        "instrument_name": "BTC-21FEB25",
        "ratio": 1
      },
      {
        "direction": "buy",
        "instrument_name": "BTC-28FEB25",
        "ratio": 1
      },
      {
        "direction": "buy",
        "instrument_name": "BTC-PERPETUAL",
        "ratio": 1
      }
    ],
    "min_trade_amount": 10,
    "makers": [
      "MAKER1",
      "MAKER2"
    ],
    "creation_timestamp": 1740047910438,
    "block_rfq_id": 321,
    "expiration_timestamp": 1740048210438,
    "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

makers

type:object

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

asks

type:array

makers

type:array

item

type:string

Maker of the quote

price

type:number

Price of a quote

last_update_timestamp

type:integer

Timestamp of the last update of the quote (milliseconds since the UNIX epoch)

execution_instruction

type:enum

Execution instruction of the quote. Default - any_part_of

"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.
"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.

Available options: any_part_of, all_or_none

amount

type:number

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

expires_at

type:integer

The timestamp when the quote expires (milliseconds since the Unix epoch), equal to the earliest expiry of placed quotes

bids

type:array

makers

type:array

item

type:string

Maker of the quote

price

type:number

Price of a quote

last_update_timestamp

type:integer

Timestamp of the last update of the quote (milliseconds since the UNIX epoch)

execution_instruction

type:enum

Execution instruction of the quote. Default - any_part_of

"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.
"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.

Available options: any_part_of, all_or_none

amount

type:number

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

expires_at

type:integer

The timestamp when the quote expires (milliseconds since the Unix epoch), equal to the earliest expiry of placed quotes

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

label

type:string

User defined label for the Block RFQ (maximum 64 characters)

app_name

type:string

The name of the application that created the Block RFQ on behalf of the user (optional, visible only to taker).

mark_price

type:number

The mark price for the instrument

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.

trade_trigger

type:object

Present only if a trade trigger was placed by the taker and only visible to taker. Only for cases: cancelled (contains the reason for cancellation) and untriggered (contains the information about the trade trigger).

state

type:enum

required

Trade trigger state: "untriggered" or "cancelled"

Available options: triggered, untriggered, cancelled

price

type:number

required

Price of the trade trigger

direction

type:enum

required

Direction of the trade trigger

Available options: buy, sell

cancel_reason

type:string

Reason for cancellation, present only when state is cancelled

trade_allocations

type:object

List of allocations for Block RFQ pre-allocation. Allows to split amount between different (sub)accounts. The taker can also allocate to himself. Visible only to the taker.

user_id

type:integer

User ID to allocate part of the RFQ amount. For brokers the User ID is obstructed.

client_info

type:object

Client allocation info for brokers.

client_id

type:integer

ID of a client; available to broker. Represents a group of users under a common name.

client_link_id

type:integer

ID assigned to a single user in a client; available to broker.

name

type:string

Name of the linked user within the client; available to broker.

amount

type:number

Amount allocated to this user or client.

block_rfq.maker.(currency) block_rfq.maker.quotes.(currency)

⌘I