Getting Transactions and Bundles for a Block

The transaction cache offers endpoints for getting simple transactions and Flashbots-style transaction bundles.

Fetching bundles requires authentication. This is because Builders are only allowed to build blocks for their assigned slots. See Authentication for details.

Transaction cache basics:

• API Endpoint: transactions.api.signet.sh

• Cache Duration: 10 minutes

• Authentication: Authentication is required to retrieve bundles, but not to retrieve transactions.

Gets all the transactions in the cache.

get

Responses

200

A list of all transactions in the cache.

application/json

get

/get

HTTPcURLJavaScriptPython

GET /get HTTP/1.1
Accept: */*

200

A list of all transactions in the cache.

[
  {
    "chainId": "0x1",
    "from": "0x53E0946bfD7C12300180CF75AE07c2Ba6a996e0a",
    "to": "0x53E0946bfD7C12300180CF75AE07c2Ba6a996e0a",
    "gasPrice": "0xbeef",
    "maxFeePerGas": "0xbeef",
    "maxPriorityFeePerGas": "0x10",
    "gas": "0x10",
    "value": "0x00",
    "input": "0x6080",
    "nonce": "0x10",
    "accessList": [
      {
        "address": "0x53E0946bfD7C12300180CF75AE07c2Ba6a996e0a",
        "storage_keys": [
          "0x1749b724562731ad1ee3ae21f2b35f81eae7c8cceda9cdc7826ead4946b320c6"
        ]
      }
    ]
  }
]

Gets all the bundles in the cache.

get

Responses

200

A list of all the bundles in the cache.

application/json

get

/get-bundles

HTTPcURLJavaScriptPython

GET /get-bundles HTTP/1.1
Accept: */*

200

A list of all the bundles in the cache.

[
  {
    "txs": [
      "0x1749b724562731ad1ee3ae21f2b35f81eae7c8cceda9cdc7826ead4946b320c6"
    ],
    "blockNumber": "0x1",
    "minTimestamp": "0x66DE2A85",
    "maxTimestamp": "0x66DE2A85",
    "revertingTxHashes": [
      "Ynl0ZXM="
    ],
    "replacementUuid": "123e4567-e89b-12d3-a456-426614174000",
    "hostFills": {
      "outputs": [
        "text"
      ],
      "permit": {
        "owner": "0x53E0946bfD7C12300180CF75AE07c2Ba6a996e0a",
        "signature": "Ynl0ZXM=",
        "permit": {
          "nonce": "Ynl0ZXM=",
          "deadline": "Ynl0ZXM=",
          "permitted": [
            {
              "token": "0x53E0946bfD7C12300180CF75AE07c2Ba6a996e0a",
              "amount": "0x2328"
            }
          ]
        }
      }
    }
  }
]