eureka_getBlockBundles

List all bundles that targeted a specific block, including which ones were included in the final block.

Parameters

Field	Type	Required	Description
blockNumber	number	Yes	The block number to query (decimal integer)

Request

{
  "jsonrpc": "2.0",
  "method": "eureka_getBlockBundles",
  "params": [{ "blockNumber": 20000000 }],
  "id": 1
}

Response

{
  "jsonrpc": "2.0",
  "result": {
    "blockNumber": 20000000,
    "targetingCount": 47,
    "servoCount": 12,
    "nonServoCount": 35,
    "includedBundles": [
      {
        "uuid": "550e8400-e29b-41d4-a716-446655440000",
        "bundleHash": "0xabcdef...",
        "builderPayment": "15000000000000000",
        "isServo": true,
        "signer": "0x1234..."
      },
      {
        "uuid": "661f9511-f30c-52e5-b827-557766551111",
        "bundleHash": "0x112233...",
        "builderPayment": "8000000000000000",
        "isServo": false,
        "signer": null
      }
    ],
    "submissionInfo": {
      "blockHash": "0xfedcba...",
      "builderPubkey": "0x8c4ed5...",
      "winningBid": "120000000000000000",
      "submittedAt": "2024-01-15T12:00:12.500Z"
    }
  },
  "id": 1
}

Response Fields

Field	Type	Description
blockNumber	number	The queried block number
targetingCount	number	Total number of bundles that targeted this block
servoCount	number	Number of Servo (MEV-share) bundles that targeted this block
nonServoCount	number	Number of non-Servo bundles that targeted this block
includedBundles	object[]	Bundles that were included in the final block
includedBundles[].uuid	string	Bundle UUID
includedBundles[].bundleHash	string | null	Bundle hash
includedBundles[].builderPayment	string	Builder payment for this bundle in wei
includedBundles[].isServo	boolean	Whether this bundle came from a Servo source
includedBundles[].signer	string | null	Signer address from the bundle submission
submissionInfo	object | null	Details about this builder's block submission to relays
submissionInfo.blockHash	string	Hash of the submitted block
submissionInfo.builderPubkey	string | null	Builder BLS public key used for submission
submissionInfo.winningBid	string | null	Winning bid amount in wei
submissionInfo.submittedAt	string | null	ISO 8601 timestamp of block submission

Notes

• Data is retained for approximately 7 days.

• Rate limit: 50 requests per second.