Analysis

Transaction risk: from raw signed tx

post

Decode a raw signed transaction, simulate via trace_call, list all touched contracts, and assess risk similarly to other endpoints.

Authorizations

APIKeyHeaderAPIKeyQuery

X-API-KeystringRequired

Body

application/json

Request model for raw signed transaction risk check.

raw_txstringRequired

0x-hex of the signed transaction

sender_addressany ofOptional

The 0x-hex address of the sender. Required if 'raw_tx' is an unsigned transaction. Ignored if 'raw_tx' is a signed transaction.

stringOptional

or

nullOptional

block_tagany ofOptional

Block tag or number

Default: latest

stringOptional

or

nullOptional

latest_offsetany ofOptional

Limit first-time checks to N latest blocks (performance control)

Default: 100

integerOptional

or

nullOptional

from_blockany ofOptional

Lower bound block for first-time checks

stringOptional

or

nullOptional

to_blockany ofOptional

Upper bound block for first-time checks

stringOptional

or

nullOptional

interaction_typeany ofOptional

Specific interaction type to evaluate. If omitted, all applicable types are used.

string · enumOptionalPossible values:

or

nullOptional

Responses

200

Successful Response

application/json

Aggregated risk verdict for a simulated or decoded transaction.

statusstring · enumRequired

Overall risk verdict. OK = no issues found; DANGEROUS = at least one first-time or unverified contract interaction; POTENTIAL_DANGEROUS = scan data is incomplete so risk cannot be ruled out.

Possible values:

interaction_statusany ofOptional

Per-interaction-type risk status. Each key is an interaction type and its value is one of: ok, dangerous, potential_dangerous, or not_checked.

or

nullOptional

dangerous_interaction_typesany ofOptional

Interaction types that triggered the DANGEROUS verdict (e.g. ["contract_direct"]). Null when status is OK.

string[]Optional

or

nullOptional

danger_reasonany ofOptional

Root cause of a non-OK verdict. FIRST_TIME_INTERACTION = sender/contract has never called this address; MISSING_HISTORY = no historical scan data available; UNVERIFIED = contract source code is not verified on-chain.

string · enumOptionalPossible values:

or

nullOptional

422

Input validation error

application/json

500

Internal server error

application/json

post

/v1/analysis/tx-risk-raw

HTTPcURLJavaScriptPython

POST /v1/analysis/tx-risk-raw HTTP/1.1
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "raw_tx": "text",
  "sender_address": "text",
  "block_tag": "latest",
  "latest_offset": 100,
  "from_block": "text",
  "to_block": "text",
  "interaction_type": "sender_direct"
}

{
  "status": "OK",
  "interaction_status": {
    "ANY_ADDITIONAL_PROPERTY": "dangerous"
  },
  "details": [
    {
      "address": "text",
      "first_time": true,
      "verification": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "depth": 1,
      "types": {
        "ANY_ADDITIONAL_PROPERTY": 1
      },
      "interaction_first_time": {
        "ANY_ADDITIONAL_PROPERTY": true
      },
      "interaction_state": {
        "ANY_ADDITIONAL_PROPERTY": "FOUND"
      }
    }
  ],
  "dangerous_interaction_types": [
    "text"
  ],
  "danger_reason": "FIRST_TIME_INTERACTION"
}