eth_callBundle

You can simulate transactions bundle in flashbots relay before send them to the miner through this api without dealing with flashbots reducing technical costs.
Supported on Ethereum, Goerli.
Parameters
Object - An object with the following fields (required):
txsHex(array of string, required) - array or string that contains raw transactions hash. 
blockNumber(integer number, optional) - the blockNumber that the bundle could be included. pass 0 than it would be set to latest future block.
Returns
Object - An object with the following fields:
id(integer number) - json-rpc id.
jsonrpc(string) - json-rpc version.
result(object) - an object with the following fields:
bundleHash(hex string) - the hash value of the bundle.
txsResult(array of objects, defined below) - simulating transactions result of the bundle.
Object schema:
fromAddress(hex string) - the origin address of the transaction.
gasPrice(integer number) - price of gas of the transaction.
txHash(hex string) - hash value of the transaction.
gasUsed(integer number) - used gas of the transaction.
metadata(object, defined below) - meta info of the transaction.
Metadata object schema:
coinbaseDiff(integer number) - the amount of ETH that miner would receiver.
ethSentToCoinbase(integer number) - the amount of ETH that pay for the miner directly.
gasFees(integer number) - the amount of gas used in this transaction.
Example
Request
curl --location --request POST 'https://apis.blockvision.org/v1/<api key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "eth_callBundle",
    "params": {
        "txsHex": [
            "0xf868820154820428825208944592d8f8d7b001e72cb26a73e4fa1806a51ac79d85e8d4a51000802da03412f32337c2b1218fd76f6d953efb487a184d2c80ce0e3d7ceb5a130f25fc91a036031b6e93392eda68b5154b01b67ba68ababe32b8c93cdcf47c66d1bb2edff1",
            "0xf868820155820428825208944592d8f8d7b001e72cb26a73e4fa1806a51ac79d85e8d4a51000802da0b0f88f3b49b63aef6148a316dbf6acb534731245b16c25110ec54f954fcef481a026fc384eaa960bed026e39e9f65ae1712ba5afb7250f7513299d896aeb384af1"
        ],
      "blockNumber": 7626710
    },
    "id": 1
}'
Result
{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "bundleHash": "0x161a90b226ba43b0e283d9fda02e801a3685fd4f550f55226016e5c4a8ab3428",
        "txsResut": [
            {
                "metadata": {
                    "coinbaseDiff": "21861000",
                    "ethSentToCoinbase": "0",
                    "gasFees": "21861000"
                },
                "fromAddress": "0x137be392780558568fc0aB86c73495243Bc6062e",
                "gasPrice": "1041",
                "txHash": "0x978f0214e0e0ff944d1798fa17b6fe55fda061465f60ee5cc4b707be6f0816fb",
                "gasUsed": 21000
            },
            {
                "metadata": {
                    "coinbaseDiff": "21861000",
                    "ethSentToCoinbase": "0",
                    "gasFees": "21861000"
                },
                "fromAddress": "0x137be392780558568fc0aB86c73495243Bc6062e",
                "gasPrice": "1041",
                "txHash": "0xc9ed41d6c50d575fcf2f83f370b094f834ecae2d08ffdfa48732c49fa81b03c0",
                "gasUsed": 21000
            }
        ]
    }
}

eth_sendBundle

eth_getBundleStats

Last modified 3d ago

Copy link

Outline

Parameters

Returns

Example

Request

Result