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

# GET /private/get_broker_trade_requests

`GET /private/get_broker_trade_requests`

**Broker Method** Provides a list of broker block trade requests including pending approvals, declined trades, and expired trades. `timestamp` and `nonce` received in response can be used to approve or reject the pending broker block trade. This method takes no parameters.

**Scope:** `block_trade:read`

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

## Response `200`

Success response

- PrivateGetBrokerTradeRequestsResponse
  - `jsonrpc` '2.0', required — The JSON-RPC version (2.0)
  - `id` integer — The id that was sent in the request
  - `result` object[], required
    - `timestamp` integer — Timestamp of the broker block trade request (milliseconds since the UNIX epoch).
    - `state` string — State of the broker block trade request.
    - `trades` object[]
      - `amount` number — Trade amount.
      - `direction` string — Trade direction (buy or sell).
      - `price` number — Trade price.
      - `instrument_name` string — Name of the traded instrument.
    - `maker` object
      - `state` string — State of the request from the maker side: `initial`, `approved`, or `rejected`.
      - `client_id` integer — ID of a client; available to broker. Represents a group of users under a common name.
      - `user_id` string — Obscured user id of the maker.
      - `client_name` string — Name of the client; available to broker.
      - `client_link_name` string — Name of the linked user within the client; available to broker.
      - `client_link_id` integer — ID assigned to a single user in a client; available to broker.
    - `taker` object
      - `state` string — State of the request from the taker side: `initial`, `approved`, or `rejected`.
      - `client_id` integer — ID of a client; available to broker. Represents a group of users under a common name.
      - `user_id` string — Obscured user id of the taker.
      - `client_name` string — Name of the client; available to broker.
      - `client_link_name` string — Name of the linked user within the client; available to broker.
      - `client_link_id` integer — ID assigned to a single user in a client; available to broker.
    - `nonce` string — Nonce for approving or rejecting the broker block trade request.

---

[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)
