🔵 Base
eth_callBundle

eth_callBundle RPC Method

Simulates a bundle of transactions against a specific block. Useful for previewing MEV or priority operations before they're included in a block.

Parameters

1. BUNDLE OBJECT  [required]

  • object – The bundle simulation object:

    • txs – Array of raw transaction strings (RLP-encoded)
    • blockNumber – Hex-encoded block number to simulate against
    • stateBlockNumber – Either a hex number or a block tag (like "latest")
    • timestamp [optional] – UNIX timestamp to simulate as block time

Request

POST https://base-mainnet.chainnodes.org/YOUR-API-KEY

Returns

  • object – Simulation results for the whole bundle:

    • bundleGasPrice – Overall gas price of the bundle
    • bundleHash – Hash of the simulated bundle
    • coinbaseDiff – Net change to coinbase balance
    • ethSentToCoinbase – ETH value sent to coinbase
    • gasFees – Total gas fees for the bundle
    • stateBlockNumber – Block state used for simulation
    • totalGasUsed – Total gas consumed by all transactions
    • results – Detailed simulation results per transaction

Each result includes:

  • coinbaseDiff
  • ethSentToCoinbase
  • fromAddress
  • gasFees
  • gasPrice
  • gasUsed
  • toAddress
  • txHash
  • value

Need RPC API keys?

Get 12.5M archival requests for free today.

GET STARTED FOR FREE

Example

💡

Confusing? Ask blockchain developers in Chainnodes Telegram Chat (opens in a new tab)

  • ✅ Send your request to the HTTPS endpoint
  • ✅ Replace YOUR-API-KEY with your key from the CHAINNODES Dashboard (opens in a new tab)
  • ✅ You can swap base-mainnet for another supported network if needed
curl https://base-mainnet.chainnodes.org/YOUR-API-KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_callBundle","params":[{"txs":["0x123abc...","0x456def..."],"blockNumber":"0xb63dcd","stateBlockNumber":"latest","timestamp":1615920932}]}'

Body

{
  "jsonrpc": "2.0",
  "id": "123",
  "result": {
    "bundleGasPrice": "476190476193",
    "bundleHash": "0x73b1e258c7a42fd0230b2fd05529c5d4b6fcb66c227783f8bece8aeacdd1db2e",
    "coinbaseDiff": "20000000000126000",
    "ethSentToCoinbase": "20000000000000000",
    "gasFees": "126000",
    "results": [
      {
        "coinbaseDiff": "10000000000063000",
        "ethSentToCoinbase": "10000000000000000",
        "fromAddress": "0x02A727155aeF8609c9f7F2179b2a1f560B39F5A0",
        "gasFees": "63000",
        "gasPrice": "476190476193",
        "gasUsed": 21000,
        "toAddress": "0x73625f59CAdc5009Cb458B751b3E7b6b48C06f2C",
        "txHash": "0x669b4704a7d993a946cdd6e2f95233f308ce0c4649d2e04944e8299efcaa098a",
        "value": "0x"
      },
      {
        "coinbaseDiff": "10000000000063000",
        "ethSentToCoinbase": "10000000000000000",
        "fromAddress": "0x02A727155aeF8609c9f7F2179b2a1f560B39F5A0",
        "gasFees": "63000",
        "gasPrice": "476190476193",
        "gasUsed": 21000,
        "toAddress": "0x73625f59CAdc5009Cb458B751b3E7b6b48C06f2C",
        "txHash": "0xa839ee83465657cac01adc1d50d96c1b586ed498120a84a64749c0034b4f19fa",
        "value": "0x"
      }
    ],
    "stateBlockNumber": 5221585,
    "totalGasUsed": 42000
  }
}
eth_callManyeth_estimateGas