---
title: "GET /private/get_block_rfqs"
method: GET
path: "/private/get_block_rfqs"
tags: ["Block RFQ", "Private"]
---

# GET /private/get_block_rfqs

`GET /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](https://docs.deribit.com/api-reference/block-rfq/private-get_block_rfq_quotes) to retrieve quotes for Block RFQs.

**📖 Related Article:** [Deribit Block RFQ API walkthrough](https://docs.deribit.com/articles/block-rfq-api-walkthrough)

**Scope:** `block_rfq:read`

[Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Fget_block_rfqs)

## Query parameters

- `count` integer
- `state` 'open' | 'filled' | 'traded' | 'cancelled' | 'expired' | 'closed'
- `role` 'any' | 'taker' | 'maker'
- `continuation` integer
- `block_rfq_id` integer
- `currency` 'BTC' | 'ETH' | 'USDC' | 'USDT' | 'any' — Currency, i.e `"BTC"`, `"ETH"`, `"USDC"`

## Response `200`

Success response

- PrivateGetBlockRfqsResponse
  - `jsonrpc` '2.0', required — The JSON-RPC version (2.0)
  - `id` integer — The id that was sent in the request
  - `result` object, required
    - `block_rfqs` BlockRfq[]
      - `creation_timestamp` integer — The timestamp when Block RFQ was created (milliseconds since the Unix epoch)
      - `expiration_timestamp` integer — The timestamp when the Block RFQ will expire (milliseconds since the UNIX epoch)
      - `block_rfq_id` integer — ID of the Block RFQ
      - `role` 'taker' | 'maker' — Role of the user in Block RFQ
      - `state` 'open' | 'filled' | 'cancelled' | 'expired' — State of the Block RFQ
      - `taker_rating` string — Rating of the taker
      - `makers` string[]
      - `amount` number — This value multiplied by the ratio of a leg gives trade size on that leg.
      - `min_trade_amount` number — Minimum amount for trading
      - `asks` object[]
        - `makers` string[]
        - `price` number — Price of a quote
        - `last_update_timestamp` integer — Timestamp of the last update of the quote (milliseconds since the UNIX epoch)
        - `execution_instruction` 'any_part_of' | 'all_or_none' — 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.
        - `amount` number — This value multiplied by the ratio of a leg gives trade size on that leg.
        - `expires_at` integer — The timestamp when the quote expires (milliseconds since the Unix epoch), equal to the earliest expiry of placed quotes
      - `bids` object[]
        - `makers` string[]
        - `price` number — Price of a quote
        - `last_update_timestamp` integer — Timestamp of the last update of the quote (milliseconds since the UNIX epoch)
        - `execution_instruction` 'any_part_of' | 'all_or_none' — 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.
        - `amount` number — This value multiplied by the ratio of a leg gives trade size on that leg.
        - `expires_at` integer — The timestamp when the quote expires (milliseconds since the Unix epoch), equal to the earliest expiry of placed quotes
      - `legs` object[]
        - `ratio` integer — Ratio of amount between legs
        - `instrument_name` string — Unique instrument identifier
        - `direction` 'buy' | 'sell' — Direction: `buy`, or `sell`
      - `hedge` BlockRfqHedgeLeg
        - `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.
        - `instrument_name` string — Unique instrument identifier
        - `direction` 'buy' | 'sell' — Direction: `buy`, or `sell`
        - `price` number — Price for a hedge leg
      - `combo_id` string — Unique combo identifier
      - `label` string — User defined label for the Block RFQ (maximum 64 characters)
      - `app_name` string — The name of the application that created the Block RFQ on behalf of the user (optional, visible only to taker).
      - `mark_price` number — The mark price for the instrument
      - `disclosed` boolean — Indicates whether the RFQ was created as non-anonymous, meaning taker and maker aliases are visible to counterparties.
      - `taker` string — Taker alias. Present only when `disclosed` is `true`.
      - `index_prices` number[]
      - `included_in_taker_rating` boolean — Indicates whether the RFQ is included in the taker's rating calculation. Present only for closed RFQs created by the requesting taker.
      - `trades` object[]
        - `direction` 'buy' | 'sell' — Direction: `buy`, or `sell`
        - `price` number — Price in base currency
        - `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.
        - `maker` string — Alias of the maker (optional)
        - `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.
      - `trade_trigger` TradeTrigger — Contains information about the trade trigger state
        - `state` 'triggered' | 'untriggered' | 'cancelled', required — Trade trigger state: `"untriggered"` or `"cancelled"`
        - `price` number, required — Price of the trade trigger
        - `direction` 'buy' | 'sell', required — Direction of the trade trigger
        - `cancel_reason` string — Reason for cancellation, present only when state is cancelled
      - `trade_allocations` object[] — List of allocations for Block RFQ pre-allocation. Allows to split amount between different (sub)accounts or broker clients. Each allocation must specify either `user_id` (for direct allocation) or `client_info` object (for broker allocation), and amount. Visible only to the taker.
        - `user_id` integer — User ID to allocate part of the RFQ amount. For brokers the User ID is obstructed.
        - `client_info` object — Client allocation info for brokers.
          - `client_id` integer — ID of a client; available to broker. Represents a group of users under a common name.
          - `client_link_id` integer — ID assigned to a single user in a client; available to broker.
          - `name` string — Name of the linked user within the client; available to broker.
        - `amount` number — Amount allocated to this user or client.
    - `continuation` string — Continuation token for pagination.

---

[API](https://skmtc.net/deribit/apis/deribit-api-2.md) · [All operations](https://skmtc.net/deribit/apis/deribit-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deribit/deribit-api-2/versions/430b3f0bc67c/schema)