Skip to main content
POST
/
v0
/
evm
/
transaction-bulk
/
scan
curl --request POST \
  --url https://api.blockaid.io/v0/evm/transaction-bulk/scan \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "chain": "ethereum",
  "account_address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
  "data": [
    {
      "data": "0x",
      "value": "0x100000000000",
      "to": "0xA4e5961B58DBE487639929643dCB1Dc3848dAF5E",
      "from": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
    },
    {
      "data": "0x",
      "value": "0xdeadbeef",
      "to": "0x0D524a5B52737C0a02880d5E84F7D20b8d66bfba",
      "from": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
    }
  ],
  "block": "20224477",
  "metadata": {
    "domain": "https://example.com"
  },
  "options": [
    "validation"
  ]
}
'
[
  {
    "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": "<any>",
              "symbol": "<any>",
              "address": "<any>",
              "logo_url": "<any>",
              "type": "<any>",
              "decimals": "<any>"
            },
            "in": [
              {
                "usd_price": "<any>",
                "summary": "<any>",
                "value": "<any>",
                "raw_value": "<any>"
              }
            ],
            "out": [
              {
                "usd_price": "<any>",
                "summary": "<any>",
                "value": "<any>",
                "raw_value": "<any>"
              }
            ],
            "balance_changes": {
              "before": "<any>",
              "after": "<any>"
            }
          }
        ],
        "traces": [
          {
            "trace_type": "AssetTrace",
            "from_address": "<string>",
            "to_address": "<string>",
            "labels": [
              "GAS_FEE"
            ],
            "type": "ERC20AssetTrace",
            "asset": {
              "name": "<any>",
              "symbol": "<any>",
              "address": "<any>",
              "logo_url": "<any>",
              "type": "<any>",
              "decimals": "<any>"
            },
            "diff": {
              "usd_price": "<any>",
              "summary": "<any>",
              "value": "<any>",
              "raw_value": "<any>"
            }
          }
        ],
        "total_usd_diff": {
          "in": "<string>",
          "out": "<string>",
          "total": "<string>"
        },
        "exposures": [
          {
            "asset_type": "ERC20",
            "asset": {
              "name": "<any>",
              "symbol": "<any>",
              "address": "<any>",
              "logo_url": "<any>",
              "type": "<any>",
              "decimals": "<any>"
            },
            "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.

​
data
Transaction · object[]
required

Transaction bulk parameters

​
options
enum<string>[]

List of one or both of options for the desired output. "simulation" - include simulation output in your response. "validation" - include security validation of the transaction 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.

​
aggregated
boolean
default:false

Should aggregate the results to one result

Response

Successful Response

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