Skip to main content
POST
/
v0
/
starknet
/
transaction
/
scan
curl --request POST \
  --url https://api.blockaid.io/v0/starknet/transaction/scan \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "chain": "mainnet",
  "options": [
    "simulation",
    "validation"
  ],
  "account_address": "0x62a2959fa6502b30cbfb51199fbbe72e72ee4f5a86ec754b4172c7d7beb6ff4",
  "transaction": {
    "version": 3,
    "nonce": "0xc",
    "sender_address": "0x1840b3c89a446c74a3962647a2a7fb449d83905c4511027dfa9e099c6886691",
    "calldata": [
      "0x1",
      "0x4b33a775b537a39c8960120806e815764f173e4fa76546e6706c31aa1b0ac4a",
      "0x994f23fef04108984d50a4f870723cd46f95d592ed3de9a13f97d5c55846fb",
      "0x9",
      "0x1",
      "0x53c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8",
      "0x1",
      "0x62a2959fa6502b30cbfb51199fbbe72e72ee4f5a86ec754b4172c7d7beb6ff4",
      "0x1",
      "0x5f612ce",
      "0x0",
      "0x0",
      "0x0"
    ],
    "chain_id": "0x534e5f4d41494e",
    "nonce_data_availability_mode": 0,
    "paymaster_data": [],
    "account_deployment_data": []
  },
  "metadata": {
    "type": "wallet",
    "url": "giftnostra.com"
  },
  "block_number": "0xa12e3"
}
'
{
  "simulation": {
    "status": "<string>",
    "assets_diffs": {},
    "exposures": {},
    "address_details": [
      {
        "account_address": "<any>",
        "description": "<string>"
      }
    ],
    "account_summary": {
      "account_assets_diffs": [
        {
          "asset": {
            "type": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "address": "<string>",
            "decimals": 123,
            "logo_url": "<string>"
          },
          "in": {
            "usd_price": "<any>",
            "summary": "<any>",
            "value": "<any>",
            "raw_value": "<any>"
          },
          "out": {
            "usd_price": "<any>",
            "summary": "<any>",
            "value": "<any>",
            "raw_value": "<any>"
          },
          "asset_type": "<string>"
        }
      ],
      "account_exposures": [
        {
          "asset": {
            "type": "<string>",
            "name": "<string>",
            "symbol": "<string>",
            "address": "<string>",
            "decimals": 123,
            "logo_url": "<string>"
          },
          "spenders": {}
        }
      ],
      "total_usd_diff": {
        "in": 123,
        "out": 123,
        "total": 123
      },
      "total_usd_exposure": {}
    },
    "block_number": "<string>"
  },
  "validation": {
    "status": "<string>",
    "result_type": "Benign",
    "description": "<string>",
    "reason": "<string>",
    "classification": "<string>",
    "features": [
      {
        "type": "Benign",
        "feature_id": "<string>",
        "description": "<string>",
        "address": "<string>"
      }
    ]
  }
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
chain
required

The chain name or chain ID A CAIP-2 or a Starknet network name or a Starknet network name

Available options:
mainnet,
sepolia
​
account_address
string
required
​
transaction
object
required
​
metadata
object
required

Metadata

​
options
enum<string>[]

List of options to include in the response

  • Options.validation: Include Options.validation output in the response

  • Options.simulation: Include Options.simulation output in the response

Minimum length: 1
​
block_number
string | null

Optional block number or tag context for the simulation

Response

Successful Response

​
simulation
object

Simulation result; Only present if simulation option is included in the request

​
validation
object

Validation result; Only present if validation option is included in the request