---
title: "GET /private/get_block_trade_requests"
method: GET
path: "/private/get_block_trade_requests"
tags: ["Block Trade", "Private"]
---

# GET /private/get_block_trade_requests

`GET /private/get_block_trade_requests`

Provides a list of block trade requests including pending approvals, declined trades, and expired trades. `timestamp` and `nonce` received in response can be used with [private/approve_block_trade](https://docs.deribit.com/api-reference/block-trade/private-approve_block_trade) or [private/reject_block_trade](https://docs.deribit.com/api-reference/block-trade/private-reject_block_trade) to approve or reject the pending block trade.

To use the block trade approval feature, an [additional API key setting feature](https://docs.deribit.com/articles/creating-api-key#block-trade-approval-feature) called `enabled_features: block_trade_approval` is required. This key has to be given to the broker/registered partner who performs the trades on behalf of the user for the feature to be active. If the user wants to approve the trade, they must approve it from a different API key that doesn't have this feature enabled.

Only broker clients can use `broker_code` to query for their broker block trade requests.

**📖 Related Article:** [Block Trading](https://docs.deribit.com/articles/block-trading-api)

**Scope:** `block_trade:read`

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

## Query parameters

- `broker_code` string

## Response `200`

Success response

- PrivateGetBlockTradeRequestsResponse
  - `jsonrpc` '2.0', required — The JSON-RPC version (2.0)
  - `id` integer — The id that was sent in the request
  - `result` PendingBlockTrade[], required
    - `nonce` string, required — Nonce that can be used to approve or reject pending block trade.
    - `timestamp` integer, required — Timestamp that can be used to approve or reject pending block trade.
    - `trades` PendingBlockTrade[], required
    - `app_name` string, required — The name of the application that executed the block trade on behalf of the user (optional).
    - `username` string — Username of the user who initiated the block trade.
    - `role` 'maker' | 'taker', required — Trade role of the user: `maker` or `taker`
    - `user_id` integer, required — Unique user identifier
    - `broker_code` string — Broker code associated with the broker block trade.
    - `broker_name` string — Name of the broker associated with the block trade.
    - `state` object, required — State of the pending block trade for current user.
      - `value` 'initial' | 'accepted' | 'rejected' | 'executed', required — State value.
      - `timestamp` integer, required — State timestamp.
    - `counterparty_state` object — State of the pending block trade for the other party (optional).
      - `value` 'initial' | 'accepted' | 'rejected' | 'executed', required — State value.
      - `timestamp` integer, required — State timestamp.
    - `combo_id` string — Combo instrument identifier

---

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