Block Trade
Private

Changed on

Returns a list of the user's block trades. If currency is not provided, returns block trades for all currencies. block_rfq_id can be provided to receive block trades related to that particular Block RFQ.

📖 Related Article: Block Trading

Scope: block_trade:read

Try in API console

get/private/get_block_trades

Request

  • Base URL
    https://test.deribit.com/api/v2
  • URL
    https://test.deribit.com/api/v2/private/get_block_trades
  • Auth
    none declared

Query parameters

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

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

The currency symbol

countinteger

Count of Block Trades returned, maximum - 101

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

block_rfq_idinteger

ID of the Block RFQ

broker_codestring
Example:2krM7sJsx

Broker code to filter block trades. Only broker clients can use broker_code to filter broker block trades. Use any for all block trades.

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": [
    {
      "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

  • 6e5c000c82a8Revision changes
    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

  • 430b3f0bc67cRevision changes
    • warning

      removed the optional property //// from the response with the status

    • info

      added the optional property //// to the response with the status