Bundle Submission

POST /v1/user/bundle/send

Send the transaction bundle for a specific slot.

HTTP

curl -H "Authorization: Bearer {{access_token}}" -X POST "$ETHGAS_API_URL/v1/user/bundle/send" \
  -H "Content-Type: application/json" \
  -d '{
    "slot": 114713,
    "replacementUuid": "01ab2371-84d6-459e-95e7-5edad485f282",
    "txs": [
      {"tx": "0x02f88582...", "canRevert": true},
      {"tx": "0x02f88582...", "ordering": 1, "canRevert": false}
    ]
  }'

Python

import requests

url = f"{ETHGAS_API_URL}/v1/user/bundle/send"
payload = {
    "slot": 114713,
    "replacementUuid": "01ab2371-84d6-459e-95e7-5edad485f282",
    "txs": [
        {"tx": "0x02f88582...", "canRevert": True},
        {"tx": "0x02f88582...", "ordering": 1, "canRevert": False}
    ]
}
headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <your-auth-token>'
}
response = requests.post(url, headers=headers, json=payload)
print(response.text)

Request Body

Parameter	Required	Type	Description
slot	YES	integer	Slot number of the block
replacementUuid	YES	string	Unique identifier for the bundle replacement
txs	YES	transactionRequest[]	List of transaction requests
└ tx	YES	string	Signed transaction (hex)
└ canRevert	YES	boolean	true = revertable, false = non-revertable
└ ordering	NO	integer	1 = top of block, -1 = bottom of block

Response Body

Name	Type	Description
success	boolean	Whether API call is successful or not
errorCode	integer	Error code (if any)
errorMsgKey	string	Error message
data	object	Response body (usually empty)