Introduction

A bundle packages multiple transactions into an indivisible unit. Transactions within a bundle are executed strictly in sequence and, by default, guarantee atomic execution (either all succeed or all fail). The execution order is determined by the sender, who can also configure which transactions are allowed to fail, providing high flexibility. Bundles are not sent to the public mempool; they are sent directly from the builder to the validator, effectively avoiding the risk of malicious MEV (Miner Extractable Value) while circulating in the public mempool.

Address：0xfb888290676ba64063ae7b165dae41511aab36ed

Description: This is an external account controlled by us. Adding a BNB transfer to this address in the bundle will increase the bundle's priority weight in the block. The weight is calculated as follows: bundle weighted average gas price * 0.9 + transfer amount.

💡 Tip The effective gas price for all data packets must be greater than or equal to 0.05 gwei.

Request Parameters

Parameter	Required	Type	Example	Description
txs	Yes	[]bytes	["0xa...b1","0x..."]	signed raw txs
maxBlockNumber	No	uint64	74925998	The maximum valid block number for this bundle, defaulting to the current block number plus 100.
revertingTxHashes	No	[]hash	["0xbc...d1","0x..."]	List of transaction hashes that can be reversed/cancelled.

Request Example

HTTP POST

curl http://bsc-eu.flashblock.trade/proxy \
    -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: <YOUR-AUTHORIZATION-HEADER>" \
    -d '{
        "jsonrpc": "2.0",
	    "id": "1",
        "method": "eth_sendBundle",
        "params": [
            {
            "txs":["0xa...b1","0x..."],
		    "maxBlockNumber":74925998,   
		    "revertingTxHashes":[],                
	        }
        ]
	}‍'

HTTPS POST

curl https://bsc-eu.flashblock.trade/proxy \
    -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: <YOUR-AUTHORIZATION-HEADER>" \
    -d '{
        "jsonrpc": "2.0",
	    "id": "1",
        "method": "eth_sendBundle",
        "params": [
            {
            "txs":["0xa...b1","0x..."],
		    "maxBlockNumber":74925998,   
		    "revertingTxHashes":[],                
	        }
        ]
	}‍'

Response Example

SUCCESS

{
    "jsonrpc":"2.0",
    "id":"1",
    "result":"0x6509be92d13dd3050b769661d21484f120e9b9474f6a8a17246675ae6c7487a0" 
}‍

FAILED

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": -32000,
        "message": "nonce too low: address 0xd723..., tx: 17 state: 18"
        }
}