Simulate a transaction with risk analysis

/v4/data/security/transaction/simulate

60000 credits per API call

Simulate a transaction against live chain state before signing or broadcasting it. The simulation returns balance movements, execution steps, and a risk assessment covering drainer patterns, suspicious approvals, delegatecalls, MEV exposure, and other threat heuristics.

Input modes — provide either:

  • from (plus optional to, value, data, nonce, fees) — simulate an unsigned transaction, or
  • rawTx — replay a signed, already-mined transaction. The transaction is

    looked up on-chain, so it must exist; to replay it accurately pass
    blockNumber = the block before it was mined.

Requests with neither from nor rawTx return 400.

RPCethereum-mainnet, bsc-mainnet, polygon-mainnet, and base-mainnet have built-in RPC support.

For any other supported chain, pass your own rpcUrl.

Other notes

  • blockNumber and gasLimit are JSON numbers; value, nonce, and the fee fields are decimal or hex strings

    (values can exceed the safe JavaScript integer range).

  • gasLimit defaults to 30,000,000 — lower it on chains with a smaller

    block gas limit (e.g. Gnosis).

  • The risk summary (score, level, title, steps, warnings, risks) is returned at the top

    level of the response.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
enum
required

Chain to simulate on.

string

Sender address. Required unless rawTx is provided.

string

Signed transaction hex of an existing on-chain transaction; replaces from/to/value/data/nonce. The transaction is looked up on-chain, so it must reference a real mined transaction.

string

Recipient address. Omit for contract creation.

string

Value in wei, as a decimal or hex string. Defaults to 0.

string

Calldata hex.

string

Transaction nonce as a decimal or hex string. Fetched from the chain when omitted.

integer
≥ 0

Simulate against this block instead of the latest.

integer

Gas limit. Defaults to 30,000,000 — lower it on chains whose block gas limit is smaller (e.g. Gnosis).

string

EIP-1559 max fee per gas, as a decimal or hex string.

string

EIP-1559 max priority fee per gas, as a decimal or hex string.

string

RPC endpoint to simulate against. Required only for chains without a built-in RPC (built-in: ethereum-mainnet, bsc-mainnet, polygon-mainnet, base-mainnet).

string
enum

Response format. dot adds a Graphviz dot string of the transfer graph. Defaults to json.

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json