BLblockaid-official
Bitcoin

Scan Transaction

Changed on

Scan a raw Bitcoin transaction for security risks before signing. Returns a validation verdict (Benign, Warning, or Malicious) and, when requested, a simulation of asset changes.

post/v0/bitcoin/transaction-raw/scan

Request

Request body

chain'bitcoin' required
optionsBitcoinOptions[]

Which parts of the response you need:

  • validation — Security verdict (Benign/Warning/Malicious) and risk explanation. Use when deciding whether to block or warn.
  • simulation — Predicted summary of balance and asset changes (e.g. "You will send 0.01 BTC to bc1q..."). Use when showing the user what the transaction does.

You can request one or both; default is both.

account_addressstring required

The Bitcoin address that owns the UTXOs being spent.

transactionstring required

The raw unsigned transaction in hexadecimal, as produced by the wallet or your app. This is the same payload the user would sign.

Response

Successful response with validation verdict and, if requested, simulation of asset changes.

For more information about responses, see the full response reference.

Note: HTTP 200 indicates the request was processed. Always check validation.status and simulation.status (when present), which may be Error with an error message (e.g. simulation failing due to invalid UTXOs).

Changes

  • 631610b498dbRevision changes
    • info

      added the new optional request property ////

    • info

      added the new optional request property ////

    • info

      added the new optional request property ////

    • info

      added the new optional request property ////

    • info

      added the new optional request property ////

    • info

      added the new optional request property ////

    • info

      added the new optional request property ////

    • info

      added the new optional request property ////

  • 5c446134d538Revision changes
    • info

      added the new optional request property //

    • info

      added the new optional request property //