Transaction Simulation - HashDit API Documentation

curl --request POST \
  --url https://service.hashdit.io/v2/hashdit/emulate \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "evm_transactions": [
    {
      "chain_id": "56",
      "from": "0x18e226459CCf0Eec276514a4fd3b226D8961e4d1",
      "to": "0x55d398326f99059fF775485246999027B3197955",
      "value": "0x0",
      "data": "0xa9059cbb000000000000000000000000cde5d48fca07f9c52300d2e65632dd71ed169b9000000000000000000000000000000000000000000003d4ff765e3ef19e953000",
      "block_height": "latest",
      "gas": "83000",
      "gas_price": "70000"
    }
  ],
  "requested_items": {
    "balance_changes": true,
    "approve_changes": true,
    "logs": true,
    "involved_address_risks": true
  }
}
'

{
  "code": "0",
  "status": "ok",
  "data": {
    "exec_summary": {
      "result_code": "000000000",
      "result_description": "Successful simulation.",
      "error_data": null
    },
    "results": [
      {
        "revert": false,
        "platform": "bsc",
        "tx_gas_used": 51639,
        "tx_gas_price": 70000,
        "sender_on_chain_balance": "167542475823978515562063",
        "balance_changes": [
          {
            "token_address": "0x55d398326f99059ff775485246999027b3197955",
            "tokenName": "Binance-Peg BSC-USD",
            "symbol": "BSC-USD",
            "divisor": "18",
            "tokenPriceUSD": "1.0001371158460857",
            "change_list": [
              {
                "address": "0x18e226459ccf0eec276514a4fd3b226d8961e4d1",
                "amount_change": "-4632631.602275",
                "begin_value": "50161676360924969337958879",
                "delta_value": "-4632631602275000000000000",
                "end_value": "45529044758649969337958879",
                "value_usd": "-4633266.81"
              }
            ]
          }
        ],
        "approve_changes": [],
        "called_addresses": [
          "0x55d398326f99059ff775485246999027b3197955"
        ],
        "involved_addresses": [
          "0x18e226459ccf0eec276514a4fd3b226d8961e4d1",
          "0x55d398326f99059ff775485246999027b3197955",
          "0xcde5d48fca07f9c52300d2e65632dd71ed169b90"
        ],
        "involved_addresses_risks": [
          {
            "address": "0x18e226459ccf0eec276514a4fd3b226d8961e4d1",
            "risk_level": 1
          },
          {
            "address": "0x55d398326f99059ff775485246999027b3197955",
            "risk_level": 0
          },
          {
            "address": "0xcde5d48fca07f9c52300d2e65632dd71ed169b90",
            "risk_level": 1
          }
        ],
        "logs": [],
        "block_height": 105010668,
        "request_id": "4b1ebfe9-0274-422e-950b-59f01f7a7510"
      }
    ]
  }
}

POST

hashdit

emulate

curl --request POST \
  --url https://service.hashdit.io/v2/hashdit/emulate \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "evm_transactions": [
    {
      "chain_id": "56",
      "from": "0x18e226459CCf0Eec276514a4fd3b226D8961e4d1",
      "to": "0x55d398326f99059fF775485246999027B3197955",
      "value": "0x0",
      "data": "0xa9059cbb000000000000000000000000cde5d48fca07f9c52300d2e65632dd71ed169b9000000000000000000000000000000000000000000003d4ff765e3ef19e953000",
      "block_height": "latest",
      "gas": "83000",
      "gas_price": "70000"
    }
  ],
  "requested_items": {
    "balance_changes": true,
    "approve_changes": true,
    "logs": true,
    "involved_address_risks": true
  }
}
'

{
  "code": "0",
  "status": "ok",
  "data": {
    "exec_summary": {
      "result_code": "000000000",
      "result_description": "Successful simulation.",
      "error_data": null
    },
    "results": [
      {
        "revert": false,
        "platform": "bsc",
        "tx_gas_used": 51639,
        "tx_gas_price": 70000,
        "sender_on_chain_balance": "167542475823978515562063",
        "balance_changes": [
          {
            "token_address": "0x55d398326f99059ff775485246999027b3197955",
            "tokenName": "Binance-Peg BSC-USD",
            "symbol": "BSC-USD",
            "divisor": "18",
            "tokenPriceUSD": "1.0001371158460857",
            "change_list": [
              {
                "address": "0x18e226459ccf0eec276514a4fd3b226d8961e4d1",
                "amount_change": "-4632631.602275",
                "begin_value": "50161676360924969337958879",
                "delta_value": "-4632631602275000000000000",
                "end_value": "45529044758649969337958879",
                "value_usd": "-4633266.81"
              }
            ]
          }
        ],
        "approve_changes": [],
        "called_addresses": [
          "0x55d398326f99059ff775485246999027b3197955"
        ],
        "involved_addresses": [
          "0x18e226459ccf0eec276514a4fd3b226d8961e4d1",
          "0x55d398326f99059ff775485246999027b3197955",
          "0xcde5d48fca07f9c52300d2e65632dd71ed169b90"
        ],
        "involved_addresses_risks": [
          {
            "address": "0x18e226459ccf0eec276514a4fd3b226d8961e4d1",
            "risk_level": 1
          },
          {
            "address": "0x55d398326f99059ff775485246999027b3197955",
            "risk_level": 0
          },
          {
            "address": "0xcde5d48fca07f9c52300d2e65632dd71ed169b90",
            "risk_level": 1
          }
        ],
        "logs": [],
        "block_height": 105010668,
        "request_id": "4b1ebfe9-0274-422e-950b-59f01f7a7510"
      }
    ]
  }
}

Request fields accept both camelCase and snake_case. See Request Field Names.

Works on EVM chains and TRON Simulation. For Solana, use Solana Transaction Simulation. chain_id is set on each transaction, not at the top level. Send an integer or a string — 56 and "56" are both valid. value, gas, gas_price, and block_height each accept several encodings of the same number:

Field	`int`	Decimal string	`0x` hex	Other
`value`	`0`	`"0"`	`"0x0"`	—
`gas`	`83000`	`"83000"`	`"0x14438"`	—
`gas_price`	`70000`	`"70000"`	`"0x11170"`	—
`block_height`	`105010668`	`"105010668"`	`"0x64255ec"`	`"latest"` (default)

requested_items is required in practice. Omitting the key is rejected with 400 invalid request. Any object works — {"balance_changes": true} is the normal minimum, and even {} is accepted.

Fields that belong to a signed transaction — nonce, type, maxFeePerGas, maxPriorityFeePerGas, accessList, v, r, s, hash, blockNumber — are accepted and ignored. You can POST a wallet’s fully populated transaction object as-is.

The legacy page listed invocation_tree. That field does not exist — use call_graph.

Chain Coverage

Chain coverage for this endpoint is broader than the list used by the analysis endpoints and expands over time. Commonly used values: 1 (Ethereum), 56 (BSC), 137 (Polygon), 42161 (Arbitrum), 728126428 (TRON). An unsupported chain is rejected with 400 invalid request. Contact support to confirm a chain not listed here.

`risk_level` Scale

Used in involved_addresses_risks.

Value	Meaning
`0`	No known risk.
`1`	Low risk.
`2`–`5`	Increasing risk.
`-1`	Not present in HashDit’s database — unknown, not safe.

A reverted transaction is a successful API call. The envelope stays code: "0", status: "ok". Read exec_summary.result_code and results[i].revert to detect the revert. Only infrastructure failures produce non-"0" codes.

Headers

X-API-KEY

string

required

Your HashDit API key

Body

application/json

Transactions to simulate and which result sections to return

evm_transactions

object[]

required

Transactions to simulate, executed in order. Minimum 1. Alias transactions also accepted.

Minimum array length: 1

Show child attributes

requested_items

object

required

Selects which sections appear in each result. Effectively required: omitting the key is rejected with 400 invalid request. Any object is accepted, including {}. {"balance_changes": true} is the normal minimum. Unset flags are off.

Show child attributes

Response

Successful API call. A reverted transaction still returns code: "0" and status: "ok" — read exec_summary.result_code and results[i].revert.

code

string

API status code. "0" indicates the API call succeeded, including when a transaction reverted.

Example:

"0"

status

string

Request status.

Example:

"ok"

data

object

Show child attributes

​Chain Coverage

​risk_level Scale

Headers

Body

Response

Chain Coverage

`risk_level` Scale