Blocks (beta)

Querying into Ethereum blocks and the associated validator metrics

The Blocks endpoints allows one to dig into the individual slots and blocks in Ethereum since the Merge (Slot 4700013, Block 15537394). Metrics include validator rewards from the consensus and execution layers, MEV data, and missed reward estimates. See the blocks glossary for the complete set of metrics.

List of slots and blocks

Get Blocks

GET/v0/eth/blocks

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

page*Page

total*Total

data*Data

nextNext

Request

JavaScriptCurlPython

const response = await fetch('/v0/eth/blocks', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "page": {
    "size": 1
  },
  "data": [
    {
      "epoch": 234440,
      "consensusSlot": 7502102,
      "consensusBlockRoot": "\\\\x5668a71163c5ec5fcf34185deb36f0c3619a6f00a4ee0a547220f439913b6412",
      "executionBlockNumber": 18312479,
      "executionBlockHash": "\\\\x5b138bff063adf335b468150d91eb8c3025a02f6716e3dd4bcee42bf81bb0fe8",
      "validatorIndex": 888078,
      "feeRecipient": "\\\\x1f9090aae28b8a3dceadf281b0f12828e676c326",
      "totalType0Transactions": 19,
      "totalType2Transactions": 137,
      "totalTransactions": 156,
      "totalGasUsed": 11894065,
      "baseFeePerGas": 7413818806,
      "totalBurntFees": 88180442776786380,
      "totalType2TxFees": 11085611875723216,
      "totalType0TxFees": 23400203843039860,
      "totalPriorityFees": 34485815,
      "baselineMev": 0,
      "executionProposerDuty": "proposed",
      "executionRewards": 34330125,
      "missedExecutionRewards": 0,
      "consensusProposerDuty": "proposed",
      "consensusRewards": 41947807,
      "missedConsensusRewards": 0,
      "totalRewards": 76277932,
      "totalRewardsMissed": 0,
      "totalType1Transactions": 0,
      "totalType1TxFees": 0,
      "blockTimestamp": 123242323,
      "totalSanctionedTransactions": 0,
      "totalPriorityFeesValidator": 34330125,
      "relays": [
        "bloxroute_regulated",
        "flashbots",
        "bloxroute_maxprofit"
      ],
      "blockBuilderPubkeys": [
        "0x978a35c39c41aadbe35ea29712bccffb117cc6ebcad4d86ea463d712af1dc80131d0c650dc29ba29ef27c881f43bd587",
        "0x978a35c39c41aadbe35ea29712bccffb117cc6ebcad4d86ea463d712af1dc80131d0c650dc29ba29ef27c881f43bd587",
        "0x978a35c39c41aadbe35ea29712bccffb117cc6ebcad4d86ea463d712af1dc80131d0c650dc29ba29ef27c881f43bd587"
      ]
    }
  ],
  "next": "/v0/eth/blocks/?size=10&from=7502092",
  "total": 1
}

This endpoint gives a paginated list of all slots and blocks.

Here's how to interpret the inputs required to operate it 👇

Parameter	Context
from	Start slot (integer)
size	The number of results included per page

Blocks by slot number

Get Blocks By Slot

GET/v0/eth/blocks/{consensus_slot}

Path parameters

consensus_slot*Consensus Slot

Header parameters

Response

200400

Successful Response

Body

application/json

epoch*Epoch

consensusSlot*Consensusslot

consensusBlockRootConsensusblockroot

executionBlockNumberExecutionblocknumber

executionBlockHashExecutionblockhash

validatorIndex*Validatorindex

feeRecipientFeerecipient

totalType0TransactionsTotaltype0Transactions

totalType2TransactionsTotaltype2Transactions

totalTransactionsTotaltransactions

totalGasUsedTotalgasused

baseFeePerGasBasefeepergas

totalBurntFeesTotalburntfees

totalType2TxFeesTotaltype2Txfees

totalType0TxFeesTotaltype0Txfees

totalPriorityFeesTotalpriorityfees

baselineMevBaselinemev

executionProposerDuty*Executionproposerduty

executionRewardsExecutionrewards

missedExecutionRewardsMissedexecutionrewards

consensusProposerDuty*Consensusproposerduty

consensusRewardsConsensusrewards

missedConsensusRewardsMissedconsensusrewards

totalRewardsTotalrewards

totalRewardsMissedTotalrewardsmissed

totalType1TransactionsTotaltype1Transactions

totalType1TxFeesTotaltype1Txfees

blockTimestampBlocktimestamp

totalSanctionedTransactionsTotalsanctionedtransactions

totalPriorityFeesValidatorTotalpriorityfeesvalidator

relays*Relays

blockBuilderPubkeys*Blockbuilderpubkeys

Request

JavaScriptCurlPython

const response = await fetch('/v0/eth/blocks/{consensus_slot}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "epoch": 234440,
  "consensusSlot": 7502102,
  "consensusBlockRoot": "\\\\x5668a71163c5ec5fcf34185deb36f0c3619a6f00a4ee0a547220f439913b6412",
  "executionBlockNumber": 18312479,
  "executionBlockHash": "\\\\x5b138bff063adf335b468150d91eb8c3025a02f6716e3dd4bcee42bf81bb0fe8",
  "validatorIndex": 888078,
  "feeRecipient": "\\\\x1f9090aae28b8a3dceadf281b0f12828e676c326",
  "totalType0Transactions": 19,
  "totalType2Transactions": 137,
  "totalTransactions": 156,
  "totalGasUsed": 11894065,
  "baseFeePerGas": 7413818806,
  "totalBurntFees": 88180442776786380,
  "totalType2TxFees": 11085611875723216,
  "totalType0TxFees": 23400203843039860,
  "totalPriorityFees": 34485815,
  "baselineMev": 0,
  "executionProposerDuty": "proposed",
  "executionRewards": 34330125,
  "missedExecutionRewards": 0,
  "consensusProposerDuty": "proposed",
  "consensusRewards": 41947807,
  "missedConsensusRewards": 0,
  "totalRewards": 76277932,
  "totalRewardsMissed": 0,
  "totalType1Transactions": 0,
  "totalType1TxFees": 0,
  "blockTimestamp": "2023-10-09T11:00:47",
  "totalSanctionedTransactions": 0,
  "totalPriorityFeesValidator": 34330125,
  "relays": [
    "bloxroute_regulated",
    "flashbots",
    "bloxroute_maxprofit"
  ],
  "blockBuilderPubkeys": [
    "0x978a35c39c41aadbe35ea29712bccffb117cc6ebcad4d86ea463d712af1dc80131d0c650dc29ba29ef27c881f43bd587",
    "0x978a35c39c41aadbe35ea29712bccffb117cc6ebcad4d86ea463d712af1dc80131d0c650dc29ba29ef27c881f43bd587",
    "0x978a35c39c41aadbe35ea29712bccffb117cc6ebcad4d86ea463d712af1dc80131d0c650dc29ba29ef27c881f43bd587"
  ]
}

This endpoint returns information about a single block, queried through the consensus slot number.

Sync Committee Rewards by Slot

Get Sync Committee Rewards By Slot

GET/v0/eth/blocks/{consensus_slot}/syncCommitteeRewards

Path parameters

consensus_slot*Consensus Slot

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

page*Page

total*Total

data*Data

nextNext

Request

JavaScriptCurlPython

const response = await fetch('/v0/eth/blocks/{consensus_slot}/syncCommitteeRewards', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "page": {
    "from": 0,
    "to": 0,
    "size": 10,
    "granularity": "hour",
    "filterType": "hour"
  },
  "total": 0,
  "data": [
    {
      "epoch": 234440,
      "consensusSlot": 7502102,
      "validatorIndex": 888078,
      "syncCommitteeRewards": 22249,
      "blockTimestamp": "2023-10-09T11:00:47"
    }
  ],
  "next": "text"
}

This endpoint returns details about sync committee rewards in the queried consensus slot.