Bundle Submission

REQUEST
Method: blxr_submit_bundle
Submit a bundle to the Cloud-API, which validates and forwards the bundle to MEV relays. Please contact bloXroute support if you have questions regarding the parameters.

Bundle Submission Rate Limits and Restriction:
Plan
Bundle Submission
Bundle Simulation
Ultra and Enterprise-Elite
Unlimited
Unlimited
Enterprise
8 bundle requests every block number
2 bundle requests every second
Not supported
Professional and Introductory
4 bundle requests every block number
1 bundle request every second
Not supported
​
Parameters
Parameter
Description
transaction
A list of raw transaction bytes without a 0x prefix. 
block_number
Block number of a future block to include this bundle in, in hex value. For traders who would like more than one block to be targeted, please send multiple requests targeting each specific block.
min_timestamp
[Optional] The minimum timestamp that the bundle is valid on, an integer in unix epoch format. Default value is None.
max_timestamp
[Optional] The maximum timestamp that the bundle is valid on, an integer in unix epoch format. Default value is None.
reverting_hashes
[Optional] A list of transaction hashes within the bundle that are allowed to revert. Default is empty list: the whole bundle would be excluded if any transaction reverts.
uuid
[Optional] A unique identifier of the bundle. This field can be used for bundle replacement and bundle cancellation. Some builders like bloxroute, builder0x69 and flashbots support this field. After receiving a new UUID bundle, the builder would replace the previous bundle that has the same UUID. When the list of transactions is empty in new UUID bundle, the previous bundle associated with the same UUID would be effectively canceled. The response is empty/null instead of bundle hash when UUID is provided in the request.
frontrunning
[Optional, default: True] A boolean flag indicating if the MEV bundle executes frontrunning strategy (e.g. generalized frontrunning, sandwiching). Some block builders and validators may not want to accept frontrunning bundles, which may experience a lower hash power.
enable_backrunme
[Optional, default: False] A boolean flag indicating if the bundle should be routed to BackRunMe service. When the bundle generates backrun arbitrage opportunities, the original bundle sender can receive 20% of the arbitrage profit. 
mev_builders
[Optional, default: bloxroute builder and flashbots builder] A dictionary of MEV builders that should receive the bundle. For each MEV builder, a signature is required. 
For flashbots builder, searchers can provide either empty string, or the signature used in X-Flashbots-Signature header, which can be constructed based on request payload {"jsonrpc":"2.0","id":"1","method":"eth_sendBundle","params":[...]}. For other builders, please provide empty string as signature. 
Possible MEV builders are:
bloxroute: bloXroute internal builder
flashbots: flashbots builder
builder0x69: builder0x69 ​
beaverbuild:  beaverbuild.org ​
buildai: buildai.net ​
all: all builders
Traders can refer to List of External Builders page for a full list.
Examples (Cloud API)
HTTPS POST
wscat
curl https://mev.api.blxrbdn.com \
    --insecure \
    -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: <YOUR-AUTHORIZATION-HEADER>" \
    -d '{
         "id": "1", 
         "method": "blxr_submit_bundle", 
         "params": {
            "transaction": ["ab..ab", "cd..cd"],
            "block_number": "0xba10d0",
            "min_timestamp": 1616511391,
            "max_timestamp": 1617806320,
            "reverting_hashes": ["0xd8..ce", "0x50..d3"],
            "uuid": "05e33611-a415-425b-b9ca-ca0ef6773461",
            "frontrunning": false,
            "enable_backrunme": true,
            "mev_builders": {
		"bloxroute": "",
		"flashbots": "<signature>",
		"builder0x69": "",
		"beaverbuild": "",
		"buildai": "",
		"all": ""
	     }
          }
        }'
 
wscat -c wss://mev.api.blxrbdn.com/ws --header "Authorization: <YOUR-AUTHORIZATION-HEADER>" --no-check 
> {
         "jsonrpc": "2.0", 
         "id": "1",
         "method": "blxr_submit_bundle", 
         "params": {
                  "transaction": ["ab..ab", "cd..cd"],
                  "block_number": "0xba10d0",
                  "min_timestamp": 1616511391,
                  "max_timestamp": 1617806320,
                  "reverting_hashes": ["0xd8..ce", "0x50..d3"],
                  "frontrunning": false,
                  "mev_builders": {
		         "bloxroute": "",
		         "flashbots": "<signature>",
		         "all": ""
	          }
         }
}
​
Example (Go Gateway)
wscat
wscat -c ws://127.0.0.1:28333/ws --header "Authorization: <YOUR-AUTHORIZATION-HEADER>"
> {
	"jsonrpc": "2.0", 
	"id": "1",
	"method": "blxr_mev_searcher", 
	"params": {
		"mev_method": "eth_sendBundle",
                "frontrunning": false,
		"mev_builders": {
			"bloxroute": "",
			"flashbots": "<signature>",
			"all": ""
		},
		"payload": [{
			"txs" : ["0xf8708344c...818765aaa"], 
			"blockNumber" : "0xb73dcd", 
			"minTimestamp": 1616511391, 
			"maxTimestamp": 1617806320,
			"revertingTxHashes": ["0xd8..ce", "0x50..d3"]
		}]
	}
}
​

Plan	Bundle Submission	Bundle Simulation
Ultra and Enterprise-Elite	Unlimited	Unlimited
Enterprise	8 bundle requests every block number 2 bundle requests every second	Not supported
Professional and Introductory	4 bundle requests every block number 1 bundle request every second	Not supported

Bundle Simulation

Block Submission

Last modified 22d ago

Parameter	Description
`transaction`	A list of raw transaction bytes without a `0x` prefix.
`block_number`	Block number of a future block to include this bundle in, in hex value. For traders who would like more than one block to be targeted, please send multiple requests targeting each specific block.
`min_timestamp`	[Optional] The minimum timestamp that the bundle is valid on, an integer in unix epoch format. Default value is None.
`max_timestamp`	[Optional] The maximum timestamp that the bundle is valid on, an integer in unix epoch format. Default value is None.
`reverting_hashes`	[Optional] A list of transaction hashes within the bundle that are allowed to revert. Default is empty list: the whole bundle would be excluded if any transaction reverts.
`uuid`	[Optional] A unique identifier of the bundle. This field can be used for bundle replacement and bundle cancellation. Some builders like `bloxroute`, `builder0x69` and `flashbots` support this field. After receiving a new UUID bundle, the builder would replace the previous bundle that has the same UUID. When the list of transactions is empty in new UUID bundle, the previous bundle associated with the same UUID would be effectively canceled. The response is empty/null instead of bundle hash when UUID is provided in the request.
`frontrunning`	[Optional, default: True] A boolean flag indicating if the MEV bundle executes frontrunning strategy (e.g. generalized frontrunning, sandwiching). Some block builders and validators may not want to accept frontrunning bundles, which may experience a lower hash power.
`enable_backrunme`	[Optional, default: False] A boolean flag indicating if the bundle should be routed to BackRunMe service. When the bundle generates backrun arbitrage opportunities, the original bundle sender can receive 20% of the arbitrage profit.
`mev_builders`	[Optional, default: `bloxroute` builder and `flashbots` builder] A dictionary of MEV builders that should receive the bundle. For each MEV builder, a signature is required. For `flashbots` builder, searchers can provide either empty string, or the signature used in `X-Flashbots-Signature` header, which can be constructed based on request payload `{"jsonrpc":"2.0","id":"1","method":"eth_sendBundle","params":[...]}`. For other builders, please provide empty string as signature. Possible MEV builders are: `bloxroute`: bloXroute internal builder `flashbots`: flashbots builder `builder0x69`: builder0x69 `beaverbuild`: beaverbuild.org `buildai`: buildai.net `all`: all builders Traders can refer to List of External Builders page for a full list.