Skip to content

Beta Block

MEV Send Beta Bundle API 1.0.0

API for submitting transaction bundles for MEV purposes on Ethereum.


Servers

Description URL
Testnet Server for MEV Send Beta Bundle https://holesky-api.securerpc.com/v2

builder


POST /MevSendBetaBundleRequest

Submit a bundle of transactions to be included in a specific block.

Description

This endpoint allows for the submission of a set of transactions as a bundle for inclusion in a specific block. It is designed for transactions that are not priority-sensitive. Transactions that exceed the block's gas limit will be dropped in the order they are listed, allowing for partial fulfillment of the bundle.

Request body

{
    "jsonrpc": "2.0",
    "method": "mev_sendBetaBundle",
    "params": [
        {
            "txs": [
                "string"
            ],
            "slot": "string"
        }
    ],
    "id": 30
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body
{
    "type": "object",
    "properties": {
        "jsonrpc": {
            "type": "string",
            "description": "JSON-RPC protocol version, should always be \"2.0\".",
            "example": "2.0"
        },
        "method": {
            "type": "string",
            "description": "The JSON-RPC method name, for this operation it should be \"mev_sendBetaBundle\".",
            "example": "mev_sendBetaBundle"
        },
        "params": {
            "type": "array",
            "description": "An array containing a single object with the transaction bundle details.",
            "items": {
                "type": "object",
                "required": [
                    "txs",
                    "slot"
                ],
                "properties": {
                    "txs": {
                        "type": "array",
                        "description": "An array of raw transactions (as hex strings) to be included in the bundle.",
                        "items": {
                            "type": "string",
                            "description": "A single raw transaction as a hex string. Regular expression for hex string validation",
                            "pattern": "^0x[a-fA-F0-9]+$"
                        }
                    },
                    "slot": {
                        "type": "string",
                        "description": "The target block number as a string for the bundle to be included. Ensures slot is numeric.",
                        "pattern": "^[0-9]+$"
                    }
                }
            }
        },
        "id": {
            "type": "integer",
            "description": "A unique identifier for the JSON-RPC request.",
            "example": 30
        }
    }
}

Response 200 OK

{
    "jsonrpc": "2.0",
    "method": "mev_sendBetaBundle",
    "params": [
        {
            "txs": [
                "string"
            ],
            "slot": "string"
        }
    ],
    "id": 30
}
⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body
{
    "type": "object",
    "properties": {
        "jsonrpc": {
            "type": "string",
            "description": "JSON-RPC protocol version, echoed back from the request.",
            "example": "2.0"
        },
        "method": {
            "type": "string",
            "description": "The JSON-RPC method name, echoed back from the request.",
            "example": "mev_sendBetaBundle"
        },
        "params": {
            "type": "array",
            "description": "An array containing a single object with the transaction bundle details, echoed back from the request.",
            "items": {
                "type": "object",
                "required": [
                    "txs",
                    "slot"
                ],
                "properties": {
                    "txs": {
                        "type": "array",
                        "description": "An array of raw transactions (as hex strings) included in the bundle, echoed back from the request.",
                        "items": {
                            "type": "string",
                            "description": "A single raw transaction as a hex string, echoed back. Regular expression for hex string validation."
                        }
                    },
                    "slot": {
                        "type": "string",
                        "description": "The target block number as a string for the bundle to be included, echoed back.  Ensures slot is numeric.",
                        "pattern": "^[0-9]+$"
                    }
                }
            }
        },
        "id": {
            "type": "integer",
            "description": "A unique identifier for the JSON-RPC request, echoed back.",
            "example": 30
        }
    }
}

Response 400 Bad Request

Response 401 Unauthorized

Response 500 Internal Server Error


Schemas

MevSendBetaBundleRequest

Name Type
id integer
jsonrpc string
method string
params Array<Properties: txs, slot>

MevSendBetaBundleResponse

Name Type
id integer
jsonrpc string
method string
params Array<Properties: txs, slot>

Tags

Name Description
builder Builder API Methods