> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cdp.coinbase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# private/verify_block_trade

> Verifies and creates a block trade signature. This is the first step in the block trade workflow - the first party calls this method to generate a signature that must be shared with the second party.

**Note:** In the API, the `direction` field is always expressed from the maker's perspective. This means that when you accept a block trade as a taker, the direction shown in the API represents the opposite side of your trade. For example, if you are buying puts as a taker, the API will show the operation as a "sell put" (maker's perspective), and you will be verifying and accepting a "sell put" block trade.

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

**Scope:** `rat#trade` or `wallet:buys:create`

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





## OpenAPI

````yaml /api-reference/coinbase-deribit-app-api/adv-starbase-openapi.json get /private/verify_block_trade
openapi: 3.0.0
info:
  description: Coinbase Retail Advanced Trade API for derivatives trading.
  title: Coinbase Retail Advanced Trade (Deribit) API
  version: 2.1.1
servers:
  - url: https://drb.coinbase.com/api/v2
security: []
tags:
  - description: Can only be used over websockets.
    name: WebSocket Only
  - description: Public methods can be used without authentication.
    name: Public
  - description: >-
      <p>Private methods require authentication. All requests must include a
      valid OAuth2 token.</p>

      <p>A token can be requested using the <a
      href="#public-auth">/public/auth</a> method.</p>

      <p>When using the websockets protocol, the token must be included as a
      parameter <code>access_token</code> in the message. When using REST (HTTP
      GET), the token may also be passed in the <code>Authorization</code>
      header.</p>
    name: Private
  - name: Authentication
  - name: Session Management
  - description: >-
      Subscription works as [notifications](#notifications), so users will
      automatically (after subscribing) receive messages from the server.
      Overview for each channel response format is described in
      [subscriptions](#subscriptions) section.
    name: Subscription Management
  - name: Account Management
  - name: Trading
  - name: Market Data
paths:
  /private/verify_block_trade:
    get:
      tags:
        - Block Trade
        - Matching Engine
        - Private
      description: >+
        Verifies and creates a block trade signature. This is the first step in
        the block trade workflow - the first party calls this method to generate
        a signature that must be shared with the second party.


        **Note:** In the API, the `direction` field is always expressed from the
        maker's perspective. This means that when you accept a block trade as a
        taker, the direction shown in the API represents the opposite side of
        your trade. For example, if you are buying puts as a taker, the API will
        show the operation as a "sell put" (maker's perspective), and you will
        be verifying and accepting a "sell put" block trade.


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


        **Scope:** `rat#trade` or `wallet:buys:create`


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

      parameters:
        - description: >-
            Timestamp, shared with other party (milliseconds since the UNIX
            epoch)
          in: query
          name: timestamp
          required: true
          schema:
            $ref: '#/components/schemas/timestamp'
        - description: Nonce, shared with other party
          in: query
          name: nonce
          required: true
          schema:
            $ref: '#/components/schemas/nonce'
        - description: Describes if user wants to be maker or taker of trades
          in: query
          name: role
          required: true
          schema:
            $ref: '#/components/schemas/role'
        - description: List of trades for block trade
          explode: true
          in: query
          name: trades
          required: true
          schema:
            items:
              properties:
                amount:
                  $ref: '#/components/schemas/amount'
                  description: >-
                    It represents the requested trade size. For perpetual and
                    inverse futures the amount is in USD units. For options and
                    linear futures it is the underlying base currency coin.
                direction:
                  $ref: '#/components/schemas/direction'
                  description: Direction of trade from the maker perspective
                instrument_name:
                  $ref: '#/components/schemas/instrument_name'
                  description: Instrument name
                price:
                  description: Price for trade
                  type: number
              type: object
            type: array
          style: form
      requestBody:
        content:
          application/json:
            examples:
              request:
                description: JSON-RPC Request Example
                value:
                  id: 1
                  jsonrpc: '2.0'
                  method: private/verify_block_trade
                  params:
                    nonce: okpdjkdo
                    role: maker
                    timestamp: 1565172650935
                    trades:
                      - amount: 40
                        direction: buy
                        instrument_name: BTC-PERPETUAL
                        price: 11624
                      - amount: 1.2
                        direction: buy
                        instrument_name: BTC-9AUG19-10250-P
                        price: 0.0707
        description: JSON-RPC request body
      responses:
        '200':
          $ref: '#/components/responses/PrivateVerifyBlockTradeResponse'
components:
  schemas:
    timestamp:
      description: The timestamp (milliseconds since the Unix epoch)
      example: 1536569522277
      type: integer
    nonce:
      description: Nonce
      example: bF1_gfgcsd
      type: string
    role:
      description: 'Trade role of the user: `maker` or `taker`'
      enum:
        - maker
        - taker
      type: string
    amount:
      description: >-
        It represents the requested order size. For perpetual and inverse
        futures the amount is in USD units. For options and linear futures it is
        the underlying base currency coin.
      type: number
    direction:
      description: 'Direction: `buy`, or `sell`'
      enum:
        - buy
        - sell
      type: string
    instrument_name:
      description: Unique instrument identifier
      example: BTC-PERPETUAL
      type: string
    PrivateVerifyBlockTradeResponse:
      properties:
        id:
          description: The id that was sent in the request
          type: integer
        jsonrpc:
          description: The JSON-RPC version (2.0)
          enum:
            - '2.0'
          type: string
        result:
          properties:
            signature:
              $ref: '#/components/schemas/block_trade_signature'
          required:
            - signature
          type: object
      required:
        - jsonrpc
        - result
      type: object
    block_trade_signature:
      description: >-
        Signature of block trade<br>It is valid only for 5 minutes around given
        timestamp
      example: >-
        1565173369982.1M9tO0Q-.z9n9WyZUU5op9pEz6Jtd2CI71QxQMMsCZAexnIfK9HQRT1pKH3clxeIbY7Bqm-yMcWIoE3IfCDPW5VEdiN-6oS0YkKUyXPD500MUf3ULKhfkmH81EZs
      type: string
  responses:
    PrivateVerifyBlockTradeResponse:
      content:
        application/json:
          examples:
            response:
              description: Response example
              value:
                jsonrpc: '2.0'
                result:
                  signature: >-
                    1565172710935.1ESE83qh.g6fbgRd4VWagaJz7xdi2WaV-q-d3J0njoz1jZavuRudZJZif9uH8XdUAx1LHsu0E3e0ZG_xe1UPYlwo41xRVrkWU6OMgygDRafUkEmBuk9iLqjc9rh4
          schema:
            $ref: '#/components/schemas/PrivateVerifyBlockTradeResponse'
      description: Success response

````