ETH Bundle Inclusion Status

REQUEST

Method: bundle_inclusion_status

Submit a request to the Cloud-API which checks if the provided Ethereum Mainnet bundle is included in the current winning block. This endpoint has a faster query handling time and allows searchers to check bundle inclusion status more switfly than ETH Bundle-Trace endpoint.

Parameters

Parameter	Description
bundle_hash	The bundle hash that will be checked if its included in the winning block.
block_number	[Optional] The block number targeted by the provided bundle. If not provided, the next block number to be landed will be chosen.

Examples

Cloud API

HTTPS POST REQUEST

curl https://mev.api.blxrbdn.com \
    --insecure \
    -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: <YOUR-AUTHORIZATION-HEADER>" \
    -d '{
         "id": "1", 
         "method": "bundle_inclusion_status", 
         "params": {
            "bundle_hash": "0x1177b2cd8dfd5c8d983e0cbda42ed150e108b944a1d8eb0c5dc360dc8b4bcbc1",
            "block_number": 20024795
          }
        }'
 

WSCAT

wscat -c wss://mev.api.blxrbdn.com/ws --header "Authorization: <YOUR-AUTHORIZATION-HEADER>" --no-check 
> {
  "id": "1",
  "method": "bundle_inclusion_status",
  "params": {
    "bundle_hash": "0x1177b2cd8dfd5c8d983e0cbda42ed150e108b944a1d8eb0c5dc360dc8b4bcbc1",
    "block_number": 20024795
  }
}

RESPONSE

{
  "id": "1",
  "result": {
    "included": false
  },
  "jsonrpc": "2.0"
}

Rate Limits and Restriction

Plan	Rate Limit
Ultra and Enterprise-Elite	200 requests every block number 50 requests every second
Enterprise	8 requests every block number 2 requests every second
Professional and Introductory	4 requests every block number 1 requests every second