Transaction Simulation

Simulates one or more EVM transactions without broadcasting them on-chain. The API evaluates token balance changes, approvals, ownership transfers, and address-level security risks to help detect malicious or unexpected behavior before execution.

POST /v2/hashdit/txn-simulation

Transaction Simulation

cURL

curl --request POST \
  --url https://service.hashdit.io/v2/hashdit/txn-simulation \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "chain_id": "56",
  "block_height": "58083468",
  "evm_transactions": [
    {
      "from": "0xfe4e28082959fc24d602719178bFC30d853a11D8",
      "to": "0x10ED43C718714eb63d5aA57B78B54704E256024E",
      "value": "0",
      "gas_limit": "300000",
      "gas_price": "150000000",
      "data": "0x...",
      "force": true
    }
  ],
  "requested_items": {
    "balance_changes": true,
    "approve_changes": false,
    "ownership_changes": false,
    "involved_address_risks": true,
    "invocation_tree": false
  },
  "request_source": "Diting"
}
'

200

{
  "code": "000000000",
  "status": "OK",
  "type": "GENERAL",
  "data": {
    "involved_addresses": [
      "0xfe4e28082959fc24d602719178bfc30d853a11d8",
      "0x10ed43c718714eb63d5aa57b78b54704e256024e",
      "0x55d398326f99059ff775485246999027b3197955"
    ],
    "involved_addresses_risks": [
      {
        "address": "0x55d398326f99059ff775485246999027b3197955",
        "risk_level": 0,
        "score": 100
      },
      {
        "address": "0x51d0efe2ad6fe5c44528c8f2b3a80ab727c3a3fc",
        "risk_level": 4,
        "score": 60
      }
    ],
    "txn_summaries": [
      {
        "from": "0xfe4e28082959fc24d602719178bFC30d853a11D8",
        "to": "0x10ED43C718714eb63d5aA57B78B54704E256024E",
        "gas_used": 229454,
        "effective_gas_price": 150000000,
        "called_addresses": [
          "0x10ed43c718714eb63d5aa57b78b54704e256024e",
          "0x55d398326f99059ff775485246999027b3197955"
        ],
        "balance_changes": [
          {
            "tokenName": "Binance-Peg BSC-USD",
            "symbol": "BSC-USD",
            "token_address": "0x55d398326f99059ff775485246999027b3197955",
            "change_list": [
              {
                "address": "0xfe4e28082959fc24d602719178bfc30d853a11d8",
                "amount_change": "228.257892352717276327",
                "value_usd": "228.155861074835611704"
              }
            ]
          }
        ]
      }
    ]
  },
  "error_data": null
}

Headers

Content-Type · string · default: application/json · required

Must be set to application/json

X-API-Key · string · required

Your HashDit API key (required for production use)

Body

application/json

Transaction simulation request

chain_id · string · required

The network chain ID. See Supported Chains for a complete list of supported networks for this endpoint.

Example:

"56"

block_height · string · required

Block height used as the simulation context.

Example:

"58083468"

evm_transactions · object[] · required

List of EVM transactions to simulate.

Show child attributes

requested_items · object · required

Show child attributes

request_source · string

Identifier for the request source (e.g. application name).

Example:

"Diting"

Response

200

application/json

Successful response

code · string

API result code.

Example:

"000000000"

status · string

Request status (OK on success).

Example:

"OK"

type · string

Simulation category.

Example:

"GENERAL"

data · object

Show child attributes

error_data · object

Error details if simulation fails.

Example:

null