alchemy_simulateExecutionBundle

post https://{network}.g.alchemy.com/v2/{apiKey}

Simulates multiple transactions sequentially and returns decoded execution traces and decoded logs.

📘
Limits & Cost
Bundle limit: 3 transactions (reach out if you want to simulate more transactions sequentially)
Cost: 4500 CUs.

Path Params

apiKey

string

required

Defaults to docs-demo

For higher throughput, create your own API key.

Body Params

integer

Defaults to 1

jsonrpc

string

Defaults to 2.0

method

string

Defaults to alchemy_simulateExecutionBundle

params

array of arrays of objects

length between 1 and 1

params

from

string

length between 42 and 42

Defaults to 0xd8da6bf26964af9d7eed9e03e53415d37aa96045

address the transaction is sent from

string

required

length between 42 and 42

Defaults to 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

address the transaction is directed to

value

string

Defaults to 0x0

amount in wei of ETH to transfer from sender to recipient

data

string

Defaults to 0xa9059cbb000000000000000000000000fc43f5f9dd45258b3aff31bdbe6561d97e8b71de00000000000000000000000000000000000000000000000000000000000f4240

gas

string

max amount of gas available to the transaction

gasPrice

string

(type 0) amount in wei per unit of gas

maxFeePerGas

string

(type 2) max amount of gas willing to be paid for the transaction (inclusive of baseFeePerGas and maxPriorityFeePerGas)

maxPriorityFeePerGas

string

(type 2) max amount of gas to be included as a tip to the validator

Response

Response body

object

integer

required

Defaults to 1

jsonrpc

string

required

Defaults to 2.0

result

object

required

calls

array of objects

required

calls*

object

type

string

required

CALL STATICCALL DELEGATECALL

from

string

required

length between 42 and 42

Defaults to 0xd8da6bf26964af9d7eed9e03e53415d37aa96045

address the transaction is sent from

string

required

length between 42 and 42

Defaults to 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

address the transaction is directed to

value

gas

string

required

(type 0) amount in wei per unit of gas

gasUsed

string

required

input

string

required

output

string

required

decoded

required

logs

array of objects

required

logs*

object

topics

array of strings

required

topics*

address

string

required

data

string

required

decoded

required

error

string

required

revertReason

string | null

The reason why a transaction would revert. This provides you with the ability to understand the cause behind a transaction's potential failure before actually executing it. For example, a revert reason could be "ERC20: transfer amount exceeds allowance".

Language

URL


xxxxxxxxxx
21
1
curl --request POST \
2
     --url https://eth-mainnet.g.alchemy.com/v2/docs-demo \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "id": 1,
8
  "jsonrpc": "2.0",
9
  "method": "alchemy_simulateExecutionBundle",
10
  "params": [
11
    [
12
      {
13
        "from": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
14
        "to": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
15
        "value": "0x0",
16
        "data": "0xa9059cbb000000000000000000000000fc43f5f9dd45258b3aff31bdbe6561d97e8b71de00000000000000000000000000000000000000000000000000000000000f4240"
17
      }
18
    ]
19
  ]
20
}
21
'