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

# private/invalidate_block_trade_signature

> Invalidates a signed block-trade side of the given subaccount, identified by its nonce, so that private/execute_block_trade rejects it. The nonce can be at most one hour ahead of the server clock. Fails with a non-unique-nonce error if the side has already executed or its execution is in progress. In rare cases an invalidated side can still execute until its window ends, five minutes after its nonce time. Returns "ok" on success. Requires the block_trade off-chain scope.



## OpenAPI

````yaml /openapi.json post /private/invalidate_block_trade_signature
openapi: 3.1.0
info:
  title: Derive v3 API
  version: 0.2.0
  description: JSON-RPC 2.0 methods, served over WebSocket and HTTP POST.
servers:
  - url: https://api.derive.xyz/v3
    description: Production (HTTP POST base)
  - url: https://testnet.api.derive.xyz/v3
    description: Testnet (HTTP POST base)
security: []
tags:
  - name: Subaccounts
    description: >-
      List, inspect, and label subaccounts, portfolios, positions, and
      collateral.
  - name: Session Keys
    description: Register, edit, and list delegated signing keys.
  - name: Account
    description: Wallet-level account information and settings.
  - name: Orderbook
    description: Place, replace, cancel, and query orders, trigger orders, and algos.
  - name: RFQ
    description: 'Request-for-quote: send RFQs, quote, and execute block trades.'
  - name: Liquidations
    description: >-
      Open a Dutch auction against a breaching subaccount, quote the auctions
      running right now, bid on them, and review past ones.
  - name: Vault Shareholders
    description: >-
      Deposit into and withdraw from vaults, and track shares, requests, and
      performance.
  - name: Vault Curators
    description: >-
      Create and operate curated vaults: settle deposit and withdrawal requests,
      and manage vault metadata.
  - name: History
    description: >-
      Per-account historical records: orders, trades, transfers, and
      settlements.
  - name: Market Maker Protection
    description: Configure, read, and reset market-maker protection.
  - name: Transfers & Withdrawals
    description: Move collateral between subaccounts, to other wallets, and on-chain.
  - name: Onchain Actions
    description: >-
      L1 onchain actions submitted via OnchainActionManager: register deposit
      addresses, list pending deposits, and inspect onchain action history.
  - name: System
    description: Rate limits, transaction lookups, and live incidents.
  - name: Market Data
    description: Instruments, currencies, tickers, and market-wide feeds.
  - name: Maker Scoring
    description: Maker programs, score breakdowns, and detailed scoring snapshots.
  - name: Referrals
    description: Referral codes and program performance.
  - name: Chat
    description: Anonymous chat rooms and conversations with the concierge.
  - name: Other
    description: Uncategorized.
paths:
  /private/invalidate_block_trade_signature:
    post:
      tags:
        - RFQ
      summary: private/invalidate_block_trade_signature
      description: >-
        Invalidates a signed block-trade side of the given subaccount,
        identified by its nonce, so that private/execute_block_trade rejects it.
        The nonce can be at most one hour ahead of the server clock. Fails with
        a non-unique-nonce error if the side has already executed or its
        execution is in progress. In rare cases an invalidated side can still
        execute until its window ends, five minutes after its nonce time.
        Returns "ok" on success. Requires the block_trade off-chain scope.
      operationId: private_invalidate_block_trade_signature
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InvalidateBlockTradeSignatureRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidateBlockTradeSignatureResponse'
        default:
          description: JSON-RPC error (see Error Codes)
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    $ref: '#/components/schemas/RPCError'
      security:
        - DeriveWallet: []
          DeriveTimestamp: []
          DeriveSignature: []
components:
  schemas:
    InvalidateBlockTradeSignatureRequest:
      type: object
      required:
        - nonce
        - subaccount_id
      properties:
        nonce:
          description: The `nonce` of the signed side.
          type: string
        subaccount_id:
          description: The subaccount of the signed side.
          type: integer
          format: uint64
          minimum: 0
    InvalidateBlockTradeSignatureResponse:
      description: The literal string `"ok"` returned on success.
      type: string
      enum:
        - ok
    RPCError:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: integer
          format: int64
        data:
          type:
            - string
            - 'null'
        message:
          type: string
  securitySchemes:
    DeriveWallet:
      type: apiKey
      in: header
      name: X-DeriveWallet
      description: The wallet the request acts for.
    DeriveTimestamp:
      type: apiKey
      in: header
      name: X-DeriveTimestamp
      description: The current time in milliseconds, as a decimal string.
    DeriveSignature:
      type: apiKey
      in: header
      name: X-DeriveSignature
      description: >-
        EIP-191 signature of the timestamp, by the wallet or one of its session
        keys.

````

## Related topics

- [RFQ Trading](https://docs.derive.xyz/trading/rfq.md)
- [Changelog](https://docs.derive.xyz/changelog.md)
- [private/verify_block_trade](https://docs.derive.xyz/api-reference/rfq/privateverify_block_trade.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.