GET /private/get_broker_trades — deribit-api-2

Block Trade

Private

Broker Method Returns list of broker block trades. If currency is not provided, returns broker block trades for all currencies.

Scope: block_trade:read

Try in API console

get/private/get_broker_trades

Query parameters

currency'BTC' | 'ETH' | 'USDC' | 'USDT' | 'EURR'

Currency, i.e "BTC", "ETH", "USDC"

The currency symbol

countinteger

Number of requested items, default - 20, maximum - 1000

start_idstring

Block trade id

Example:154

Response will contain block trades older than the one provided in this field

end_idstring

Block trade id

Example:154

The id of the oldest block trade to be returned, start_id is required with end_id

Response

Success response

jsonrpc'2.0' required

The JSON-RPC version (2.0)

idinteger

The id that was sent in the request

Example response

{
  "result": {
    "history": [
      {
        "trades": [
          {
            "id": "154",
            "timestamp": 1536569522277,
            "trades": [
              {
                "instrument_name": "BTC-PERPETUAL",
                "timestamp": 1517329113791,
                "starbase_timestamp": 1536569522277000000,
                "starbase_order_id": 103148386170,
                "block_trade_id": "154",
                "block_trade_leg_count": 3
              }
            ],
            "app_name": "Example Application",
            "broker_code": "2krM7sJsx",
            "broker_name": "Test Broker"
          }
        ]
      }
    ]
  }
}

Changes

Changed in 3 of the 7 revisions of this API.15

Aug 12, 20266e5c000c82a83See the full diff
- ○
  added the optional property result/history/items/trades/items/trades/items/block_trade_leg_count to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property result/history/items/trades/items/trades/items/original_order_type to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property result/history/items/trades/items/trades/items/starbase_client_order_id to the response with the 200 status
  response-optional-property-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 31, 2026430b3f0bc67c11See the full diff
- ●
  removed the optional property result/history/items/trades/items/trades/items/block_trade_leg_count from the response with the 200 status
  response-optional-property-removed
- ○
  added the optional property result/history/items/trades/items/trades/items/starbase_order_id to the response with the 200 status
  response-optional-property-added
Jul 26, 2026cc08850a8d921See the full diff
- ○
  added the optional property result/history/items/trades/items/trades/items/block_trade_leg_count to the response with the 200 status
  response-optional-property-added

Full history