Slot Bundles

GET /v1/p/bundles

Retrieve bundles for a given slot. Public endpoint — no authentication required.

HTTP

curl -X GET "$ETHGAS_API_URL/v1/p/bundles?slot=2870227"

Python

import requests

url = f"{ETHGAS_API_URL}/v1/p/bundles"
params = {'slot': 2870227}
response = requests.get(url, params=params)
print(response.text)

Request

Parameter	Required	Type	Description
slot	YES	integer	Slot number of the block

Response Body

Field	Type	Description
slot	integer	Slot ID of the retrieved bundles
bundles	array	List of bundles
└ uuid	string	Unique identifier for the bundle (or replacementUuid)
└ averageBidPrice	number	Average bid price for the bundle
└ txs	list	List of transactions
└└ tx	string	Signed transaction (hex encoded)
└└ canRevert	boolean	revertable: true, non-revertable: false
└└ createDate	integer	Date of submitting the transaction

Example Response

{
  "success": true,
  "data": {
    "slot": 2870227,
    "bundles": [
      {
        "txs": [
          {
            "tx": "0x02f86b0180843b9aca00...",
            "canRevert": false,
            "createDate": 1730193765339
          }
        ],
        "uuid": "ab592371-84d6-459e-95e7-5edad485f282",
        "averageBidPrice": 1.2635975e-8
      }
    ]
  }
}

---

GET /v1/slot/bundles

Retrieve bundles for a given slot. Requires authentication.

HTTP

curl -H "Authorization: Bearer {{access_token}}" -X GET "$ETHGAS_API_URL/v1/slot/bundles?slot=123"

Python

import requests

url = f"{ETHGAS_API_URL}/v1/slot/bundles"
params = {'slot': 123}
headers = {'Authorization': 'Bearer <your-auth-token>'}
response = requests.get(url, headers=headers, params=params)
print(response.text)

Request

Parameter	Required	Type	Description
slot	YES	integer	Slot ID to retrieve bundles

Response Body

Field	Type	Description
slot	integer	Slot ID of the retrieved bundles
emptySpace	integer	Empty preconf reserved by preconf owner
isSold	boolean	Whether block/preconf has been sold
builders	list	List of builder addresses for that slot
isOfac	boolean	OFAC restrictions for the slot
bundles	array	List of bundles
└ replacementUuid	string	Unique identifier for the bundle
└ bidPrice	number	Average bid price for the bundle
└ txs	list	List of transactions

Example Response

{
  "success": true,
  "data": {
    "slot": 123,
    "emptySpace": 0,
    "isSold": true,
    "builders": [
      "0x313233313331330000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "0xa1885d66bef164889a2e35845c3b626545d7b0e513efe335e97c3a45e534013fa3bc38c3b7e6143695aecc4872ac52c4"
    ],
    "isOfac": false,
    "bundles": [
      {
        "replacementUuid": "ab592371-84d6-459e-95e7-5edad485f282",
        "bidPrice": 1.2635975e-8,
        "txs": [
          {
            "tx": "0x02f86b0180843b9aca00...",
            "txHash": "0x87037874aed04e51c29f582394217a0a2b89d808080...",
            "canRevert": false
          }
        ]
      }
    ]
  }
}

---

GET /v1/slot/account/bundles

Retrieve bundles submitted for a given slot for your inclusion preconf account.

HTTP

curl -H "Authorization: Bearer {{access_token}}" -X GET "$ETHGAS_API_URL/v1/slot/account/bundles?slot=123"

Python

import requests

url = f"{ETHGAS_API_URL}/v1/slot/account/bundles"
params = {'slot': 123}
headers = {'Authorization': 'Bearer <your-auth-token>'}
response = requests.get(url, headers=headers, params=params)
print(response.text)

Request

Parameter	Required	Type	Description
slot	YES	integer	Slot ID to retrieve bundles

Example Response

{
  "success": true,
  "data": {
    "slot": 123,
    "bundles": [
      {
        "replacementUuid": "ab592371-84d6-459e-95e7-5edad485f282",
        "bidPrice": 1.2635975e-8,
        "txs": [
          {
            "tx": "0x02f86b0180843b9aca00...",
            "txHash": "0x1234567890abcdef...",
            "canRevert": false
          }
        ]
      }
    ]
  }
}

---

POST /v1/slot/forceEmptyBlockSpace

Preconf owner set unused inclusion preconf gas to be empty for a given slot. Set after inclusion preconf is bought.

HTTP

curl -H "Authorization: Bearer {{access_token}}" -X POST "$ETHGAS_API_URL/v1/slot/forceEmptyBlockSpace?slot=123&enable=true"

Python

import requests

url = f"{ETHGAS_API_URL}/v1/slot/forceEmptyBlockSpace"
params = {'slot': 123, 'enable': True}
headers = {'Authorization': 'Bearer <your-auth-token>'}
response = requests.post(url, headers=headers, params=params)
print(response.text)

Request

Parameter	Required	Type	Description
slot	YES	integer	Slot ID to update
enable	YES	boolean	true to force empty gas space in the slot