Skip to main content
POST
/
v0
/
evm
/
json-rpc
/
scan
curl --request POST \
  --url https://api.blockaid.io/v0/evm/json-rpc/scan \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "chain": "ethereum",
  "account_address": "0x49c73c9d361c04769a452E85D343b41aC38e0EE4",
  "data": {
    "method": "eth_signTypedData_v4",
    "params": [
      "0x49c73c9d361c04769a452E85D343b41aC38e0EE4",
      "{\"domain\":{\"chainId\":1,\"name\":\"Aave interest bearing WETH\",\"version\":\"1\",\"verifyingContract\":\"0x030ba81f1c18d280636f32af80b9aad02cf0854e\"},\"message\":{\"owner\":\"0x49c73c9d361c04769a452E85D343b41aC38e0EE4\",\"spender\":\"0xa74cbd5b80f73b5950768c8dc467f1c6307c00fd\",\"value\":\"115792089237316195423570985008687907853269984665640564039457584007913129639935\",\"nonce\":\"0\",\"deadline\":\"1988064000\",\"holder\":\"0x49c73c9d361c04769a452E85D343b41aC38e0EE4\"},\"primaryType\":\"Permit\",\"types\":{\"EIP712Domain\":[{\"name\":\"name\",\"type\":\"string\"},{\"name\":\"version\",\"type\":\"string\"},{\"name\":\"chainId\",\"type\":\"uint256\"},{\"name\":\"verifyingContract\",\"type\":\"address\"}],\"Permit\":[{\"name\":\"owner\",\"type\":\"address\"},{\"name\":\"spender\",\"type\":\"address\"},{\"name\":\"value\",\"type\":\"uint256\"},{\"name\":\"nonce\",\"type\":\"uint256\"},{\"name\":\"deadline\",\"type\":\"uint256\"}]}}"
    ]
  },
  "options": [
    "simulation",
    "validation"
  ],
  "metadata": {
    "domain": "https://boredapeyartclub.com"
  },
  "block": "18370320"
}
'
{
  "validation": {
    "result_type": "Malicious",
    "description": "A known malicious address is involved in the transaction",
    "reason": "seaport_farming",
    "features": []
  },
  "simulation": {
    "assets_diffs": {
      "0x5E1a0D484c5F0DE722E82f9dca3A9d5A421d47cB": [
        {
          "asset": {
            "type": "NATIVE",
            "name": "Ether",
            "symbol": "ETH",
            "chain_name": "Ethereum Mainnet",
            "chain_id": 1,
            "decimals": 18
          },
          "in": [
            {
              "usd_price": "1.645988685000000062",
              "summary": "Received 0.001 ETH",
              "value": "0.001",
              "raw_value": "0x38d7ea4c68000"
            }
          ],
          "out": []
        },
        {
          "asset": {
            "type": "ERC721",
            "name": "BoredApeYachtClub",
            "symbol": "BAYC",
            "address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
          },
          "in": [],
          "out": [
            {
              "usd_price": "39859.294199999996635597",
              "summary": "Sent BoredApeYachtClub #5312",
              "token_id": "0x14c0",
              "raw_value": "5898423"
            }
          ]
        }
      ],
      "0x1111222233334444555566667777888899990000": [
        {
          "asset": {
            "type": "NATIVE",
            "name": "Ether",
            "symbol": "ETH",
            "chain_name": "Ethereum Mainnet",
            "chain_id": 1,
            "decimals": 18
          },
          "in": [],
          "out": [
            {
              "usd_price": "1.645988685000000062",
              "summary": "Sent 0.001 ETH",
              "value": "0.001",
              "raw_value": "0x38d7ea4c68000"
            }
          ]
        }
      ],
      "0xa9cfc982A66D0134FEe2539cFd633559Fb5cf9a0": [
        {
          "asset": {
            "type": "ERC721",
            "name": "BoredApeYachtClub",
            "symbol": "BAYC",
            "address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
          },
          "in": [
            {
              "usd_price": "39859.294199999996635597",
              "summary": "Received BoredApeYachtClub #5312",
              "token_id": "0x14c0"
            }
          ],
          "out": []
        }
      ]
    },
    "total_usd_diff": {
      "0x1111222233334444555566667777888899990000": {
        "in": "0.0",
        "out": "1.645988685000000062",
        "total": "-1.645988685000000062"
      },
      "0x5E1a0D484c5F0DE722E82f9dca3A9d5A421d47cB": {
        "in": "1.645988685000000062",
        "out": "39859.294199999996635597",
        "total": "-39857.648211314997752197"
      },
      "0xa9cfc982A66D0134FEe2539cFd633559Fb5cf9a0": {
        "in": "39859.294199999996635597",
        "out": "0.0",
        "total": "39859.294199999996635597"
      }
    },
    "exposures": {},
    "total_usd_exposure": {},
    "address_details": {
      "0x1111222233334444555566667777888899990000": {},
      "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D": {
        "name_tag": "Bored Ape Yacht Club: BAYC Token",
        "contract_name": "BoredApeYachtClub"
      },
      "0x5E1a0D484c5F0DE722E82f9dca3A9d5A421d47cB": {},
      "0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC": {
        "name_tag": "Seaport 1.5",
        "contract_name": "Seaport"
      },
      "0xa9cfc982A66D0134FEe2539cFd633559Fb5cf9a0": {
        "name_tag": "Fake_Phishing7802"
      }
    }
  }
}

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
object
required

JSON-RPC request that was received by the wallet.

​
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.

​
account_address
string
default:""

The address of the account (wallet) received the request in hex string format

Response

Success

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