Sign in
Bitcoin

Scan Transaction

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 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

Changed in 3 of the 95 revisions of this API.14

  • 631610b498db8See the full diff
    • ○

      added the new optional request property ////

      new-optional-request-property

    • ○

      added the new optional request property ////

      new-optional-request-property

    • ○

      added the new optional request property ////

      new-optional-request-property

    • ○

      added the new optional request property ////

      new-optional-request-property

    • ○

      added the new optional request property ////

      new-optional-request-property

    • ○

      added the new optional request property ////

      new-optional-request-property

    • ○

      added the new optional request property ////

      new-optional-request-property

    • ○

      added the new optional request property ////

      new-optional-request-property

    This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 5c446134d5382See the full diff
    • ○

      added the new optional request property //

      new-optional-request-property

    • ○

      added the new optional request property //

      new-optional-request-property

  • a8bd546a37394See the full diff
    • ○

      added the new optional request property //

      new-optional-request-property

    • ○

      added the new optional request property //

      new-optional-request-property

    • ○

      added the new optional request property //

      new-optional-request-property

    • ○

      added the new optional request property //

      new-optional-request-property

Of the 95 revisions, 1 has no diff computed.