Skip to main content
POST
/
v0
/
evm
/
transaction
/
scan
curl --request POST \
  --url https://api.blockaid.io/v0/evm/transaction/scan \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "chain": "ethereum",
  "data": {
    "from": "0x5e1a0d484c5f0de722e82f9dca3a9d5a421d47cb",
    "to": "0x0d524a5b52737c0a02880d5e84f7d20b8d66bfba",
    "data": "0x",
    "value": "0x1000000000000000"
  },
  "options": [
    "simulation",
    "validation"
  ],
  "metadata": {
    "domain": "https://boredapeyartclub.com"
  },
  "block": "21211118"
}
'
{
  "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
object
required

Transaction parameters

​
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