Skip to main content
POST
Scan Raw EVM Transaction for Security Risks

Authorizations

x-api-key
string
header
required

Path Parameters

fromAddress
string
required

EVM address that signed the transaction

Query Parameters

chain
enum<string>

Chain slug (eth, bsc, pol, opt, arb, base). Optional: the body chain id is used when absent; the query wins when both are given.

Available options:
eth,
bsc,
pol,
opt,
arb,
base
refreshCache
boolean
default:false

Force refresh cached risk data

Body

application/json
tx
object
required

Transaction details

chain

Chain id (1 Ethereum, 56 BSC, 137 Polygon, 10 Optimism, 42161 Arbitrum, 8453 Base) as a number or a decimal / 0x hex string, or a chain slug. Required unless the chain query is given (the query wins). Testnet ids are rejected.

Example:

1

block
integer

With a 66-character transaction hash in tx.raw: the block of the mined transaction. With raw transaction bytes: the block whose state the simulation runs against, to replay a transaction's asset changes as of that block (pass a block before the one that mined it). Only the simulation is pinned: address and token risk use current data. A pinned replay returns no signed descriptor (and no public_key_id), since it does not describe the transaction against today's state. Omit it to simulate against the latest block. A block past the chain head is rejected.

Example:

12345678

operation
enum<integer>

Safe operation for raw transaction bytes. 1 simulates the call as a DELEGATECALL made by the Safe at fromAddress, through the Safe's own execTransaction: the target's code runs on the Safe's storage, address and balance (for example a MultiSend batch), so the asset changes are the Safe's, and the delegatecall target is always scored. The transaction value is ignored, as the Safe ignores it for a delegatecall. 0 or omitted is a plain call. 1 is not accepted with a transaction hash, with bytes that are already mined, or with bytes that have no to. An operation: 1 scan returns no signed descriptor (and no public_key_id): the descriptor cannot say the call ran as a delegatecall.

Available options:
0,
1
Example:

1

domain
string

dApp origin (e.g. app.uniswap.org). Scored and returned as the informational top-level domainRisk; it does not change the descriptor on this route.

Response

Transaction risk analysis completed successfully

simulation
array

Transaction simulation results with risk analysis including partyRisk, counterpartyRisk, assetRisk, and functionRisk (if risky 4-byte signature detected)

block
integer | null

Block number of a mined transaction; null for a pending simulation, including a replay pinned with the request block (always present).

timestamp
string<date-time>

Timestamp of the scan

chain
string

Chain identifier

Example:

"eth"

domainRisk
object | null

Risk of the domain sent in the request (riskLevel, description, message); absent when no domain was sent. Informational on this route.

public_key_id
string

Id of the key that signed descriptor. Absent for a replay pinned with the request block and for an operation: 1 scan.

descriptor
string

Hex-encoded, signed summary of the verdict for hardware-wallet (Ledger) display. API consumers can ignore it. Absent for a replay pinned with the request block and for an operation: 1 scan.