Skip to main content
POST
/
v0
/
evm
/
transaction-raw
/
scan
Scan Raw Transaction
curl --request POST \
  --url https://api.blockaid.io/v0/evm/transaction-raw/scan \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "chain": "ethereum",
  "data": "0x02f903f8018208488405f5e100850a9a03feb38302fa6a941111111254eeb25477b68fb85ed929f73a96058280b9038862e238bb00000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000002e00000000000000000000000000000000000000000000000000000000000000360000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ab3e25398a24d6af080000000000000000000000000000000000000000000000000000000070db68f000000000000000000000000000000000000000000000000000000c0c2f020e4000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec70000000000000000000000006e2a43be0b1d33b726f0ca3b8de60b3482b8b050000000000000000000000000b78ed0dd769e3fbd8e2b526f6f75dcccc7e2af4f0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000773594000000000000000000000000000000000000000000000000b4b34aede8e617e060000000a4000000a4000000a4000000a400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000014000000000000000000000000000000000000000000000000000000000000000a4bf15fcd8000000000000000000000000303389f541ff2d620e42832f180a08e767b28e10000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000242cc2878d0064b6509600000000060000b78ed0dd769e3fbd8e2b526f6f75dcccc7e2af4f00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000041a946fd8d5b9e873563a1411cbdf290b8310d8cdddc94da3aebf95b16a6dc0bf56d736ece63e3906527b7dcf08aa845d6a5cd4e0d99c9994f617b6faa378317f71c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000e26b9977c001a0386a78e05b5ab3b4badbae843aaa6ed379b2f4353aa730c8f360141e72cba692a036ed37a00c6364685e58bc0cd9cdd1c140d6690c3c0d216c1b67e3d262e2f0f9",
  "options": [
    "simulation",
    "validation"
  ],
  "metadata": {
    "domain": "https://app.1inch.io"
  },
  "account_address": "0x362320f3a3eeeb4c4699b1b9062a84B2612bcdba",
  "block": "17718858"
}
'
{
  "validation": {
    "status": "Success",
    "result_type": "Benign",
    "description": "",
    "reason": "",
    "classification": "",
    "features": [
      {
        "type": "Malicious",
        "feature_id": "<string>",
        "description": "<string>",
        "address": "<string>",
        "metadata": {}
      }
    ]
  },
  "simulation": {
    "status": "Success",
    "assets_diffs": {},
    "total_usd_diff": {},
    "exposures": {},
    "total_usd_exposure": {},
    "address_details": {},
    "account_summary": {
      "assets_diffs": [
        {
          "asset_type": "ERC20",
          "asset": {
            "name": "<string>",
            "symbol": "<string>",
            "address": "<string>",
            "logo_url": "<string>",
            "type": "ERC20",
            "decimals": 123
          },
          "in": [
            {
              "usd_price": "<string>",
              "summary": "<string>",
              "value": "<string>",
              "raw_value": "<string>"
            }
          ],
          "out": [
            {
              "usd_price": "<string>",
              "summary": "<string>",
              "value": "<string>",
              "raw_value": "<string>"
            }
          ],
          "balance_changes": {
            "before": {},
            "after": {}
          }
        }
      ],
      "traces": [
        {
          "trace_type": "AssetTrace",
          "from_address": "<string>",
          "to_address": "<string>",
          "labels": [
            "GAS_FEE"
          ],
          "type": "ERC20AssetTrace",
          "asset": {
            "name": "<string>",
            "symbol": "<string>",
            "address": "<string>",
            "logo_url": "<string>",
            "type": "ERC20",
            "decimals": 123
          },
          "diff": {
            "usd_price": "<string>",
            "summary": "<string>",
            "value": "<string>",
            "raw_value": "<string>"
          }
        }
      ],
      "total_usd_diff": {
        "in": "<string>",
        "out": "<string>",
        "total": "<string>"
      },
      "exposures": [
        {
          "asset_type": "ERC20",
          "asset": {
            "name": "<string>",
            "symbol": "<string>",
            "address": "<string>",
            "logo_url": "<string>",
            "type": "ERC20",
            "decimals": 123
          },
          "spenders": {}
        }
      ],
      "total_usd_exposure": {}
    },
    "params": {
      "from": "<string>",
      "to": "<string>",
      "value": "<string>",
      "data": "<string>",
      "gas": "<string>",
      "gas_price": "<string>",
      "block_tag": "<string>",
      "chain": "<string>",
      "calldata": {
        "function_selector": "<string>",
        "function_signature": "<string>",
        "function_declaration": "<string>"
      },
      "user_operation_calldata": {
        "function_selector": "<string>",
        "function_signature": "<string>",
        "function_declaration": "<string>"
      }
    },
    "contract_management": {},
    "session_key": {}
  },
  "events": [
    {
      "emitter_address": "<string>",
      "emitter_name": "<string>",
      "name": "<string>",
      "params": [
        {
          "type": "<string>",
          "value": "<string>",
          "internalType": "<string>",
          "name": "<string>"
        }
      ],
      "topics": [
        "<string>"
      ],
      "data": "<string>"
    }
  ],
  "gas_estimation": {
    "status": "Success",
    "used": "<string>",
    "estimate": "<string>"
  },
  "features": {},
  "block": "<string>",
  "chain": "<string>",
  "account_address": "<string>"
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
chain
required

The chain name or chain ID

Available options:
arbitrum,
avalanche,
base,
base-sepolia,
lordchain,
lordchain-testnet,
metacade,
metacade-testnet,
bsc,
ethereum,
optimism,
polygon,
zksync,
zksync-sepolia,
zora,
linea,
blast,
scroll,
ethereum-sepolia,
degen,
avalanche-fuji,
immutable-zkevm,
immutable-zkevm-testnet,
gnosis,
worldchain,
soneium-minato,
ronin,
apechain,
zero-network,
berachain,
berachain-bartio,
ink,
ink-sepolia,
abstract,
abstract-testnet,
soneium,
unichain,
sei,
flow-evm
​
metadata
object
required

Object of additional information to validate against.

​
account_address
string
required

The address to relate the transaction to. Account address determines in which perspective the transaction is simulated and validated.

​
data
string
required

Hex string of the raw transaction data

​
options
enum<string>[]

List of one or more of options for the desired output. "simulation" - include simulation output in your response. "validation" - include security validation of the transaction in your response. "gas_estimation" - include gas estimation result in your response. Default is ["validation"]

Minimum length: 1
​
block
default:latest

The relative block for the block validation. Can be "latest" or a block number.

​
state_override
object

Override the state of the chain. This is useful for testing purposes.

​
simulate_with_estimated_gas
boolean
default:false

Simulate transactions using gas estimation result. This requires "gas_estimation" option to be enabled.

Response

Successful Response

​
block
string
required
​
chain
string
required
​
validation
object
​
simulation
object
​
events
TransactionScanEvent · object[]
​
gas_estimation
object
​
features
object
​
account_address
string