Skip to main content
POST
/
v0
/
bitcoin
/
transaction-raw
/
scan
Scan Transaction
curl --request POST \
  --url https://api.blockaid.io/v0/bitcoin/transaction-raw/scan \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "chain": "bitcoin",
  "options": [
    "validation",
    "simulation"
  ],
  "account_address": "<string>",
  "transaction": "<string>",
  "metadata": {
    "type": "<string>",
    "url": "<string>"
  }
}
'
{
  "simulation": {
    "status": "<string>",
    "assets_diffs": {},
    "address_details": [
      {
        "account_address": "<string>",
        "description": "<string>"
      }
    ],
    "account_summary": {
      "account_assets_diffs": [
        {
          "asset": {
            "type": "<string>",
            "symbol": "<string>",
            "name": "<string>",
            "decimals": 123,
            "logo_url": "<string>"
          },
          "in": {
            "usd_price": 123,
            "summary": "<string>",
            "value": "<string>",
            "raw_value": 123
          },
          "out": {
            "usd_price": 123,
            "summary": "<string>",
            "value": "<string>",
            "raw_value": 123
          },
          "asset_type": "<string>"
        }
      ],
      "total_usd_diff": {
        "in": 123,
        "out": 123,
        "total": 123
      }
    }
  },
  "validation": {
    "status": "<string>",
    "result_type": "Benign",
    "description": "<string>",
    "reason": "<string>",
    "classification": "<string>",
    "features": [
      {
        "type": "Benign",
        "feature_id": "<string>",
        "description": "<string>",
        "address": "<string>"
      }
    ]
  }
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
chain
enum<string>
required
Available options:
bitcoin
​
account_address
string
required
​
transaction
string
required
​
metadata
object
required

Metadata

​
options
enum<string>[]

List of options to include in the response

  • Options.validation: Include Options.validation output in the response

  • Options.simulation: Include Options.simulation output in the response

Minimum length: 1

Response

Successful Response

​
simulation
object

Simulation result; Only present if simulation option is included in the request

​
validation
object

Validation result; Only present if validation option is included in the request