Network

Querying into network aggregate stats.

The endpoints that make up /network allow querying into a collection of statistics that provide an overview of the whole network in historical states––which can be as recent as the last 24h. For a materialized view of most of the metrics on this page, see rated.network/overview.

Network performance statistics

Get Network Stats

GET/v0/eth/network/stats
Header parameters
Response

Successful Response

Body
day*Day
avgUptime*Avguptime
avgInclusionDelay*Avginclusiondelay
avgCorrectness*Avgcorrectness
avgValidatorEffectiveness*Avgvalidatoreffectiveness
Request
const response = await fetch('/v0/eth/network/stats', {
    method: 'GET',
    headers: {},
});
const data = await response.json();
Response
[
  {
    "day": 796,
    "avgUptime": 0.9957368996638016,
    "avgInclusionDelay": 1.0192267929181533,
    "avgCorrectness": 0.9908021620574459,
    "avgValidatorEffectiveness": 97.15146353052468
  }
]

This endpoint returns summary key performance statistics for all the whole network, for the current calendar day.

Network overview

Get Network Overview

GET/v0/eth/network/overview
Header parameters
Response

Successful Response

Body
timeWindow*TimeWindow

An enumeration.

1d7d30dall
validatorCount*Validatorcount
validatorCountDiffValidatorcountdiff
medianValidatorAgeDays*Medianvalidatoragedays
activeStake*Activestake
activeStakeDiffActivestakediff
avgValidatorBalance*Avgvalidatorbalance
avgValidatorBalanceDiffAvgvalidatorbalancediff
consensusLayerRewardsPercentageConsensuslayerrewardspercentage
priorityFeesPercentagePriorityfeespercentage
baselineMevPercentageBaselinemevpercentage
avgValidatorEffectivenessAvgvalidatoreffectiveness
avgInclusionDelayAvginclusiondelay
avgUptimeAvguptime
sumMissedSlots*Summissedslots
missedSlotsPercentage*Missedslotspercentage
avgConsensusAprPercentageAvgconsensusaprpercentage
avgExecutionAprPercentageAvgexecutionaprpercentage
medianConsensusAprPercentageMedianconsensusaprpercentage
medianExecutionAprPercentageMedianexecutionaprpercentage
consensusRewardsRatioConsensusrewardsratio
executionRewardsRatioExecutionrewardsratio
avgNetworkAprPercentageAvgnetworkaprpercentage
medianNetworkAprPercentageMediannetworkaprpercentage
avgConsensusAprGweiAvgconsensusaprgwei
avgExecutionAprGweiAvgexecutionaprgwei
medianConsensusAprGweiMedianconsensusaprgwei
medianExecutionAprGweiMedianexecutionaprgwei
avgNetworkAprGweiAvgnetworkaprgwei
medianNetworkAprGweiMediannetworkaprgwei
giniCoefficient*Ginicoefficient
clientPercentages*Clientpercentages
clientValidatorEffectivenessClientvalidatoreffectiveness
latestEpoch*Latestepoch
activationQueueMinutes*Activationqueueminutes
activatingValidators*Activatingvalidators
activatingStake*Activatingstake
exitQueueMinutes*Exitqueueminutes
withdrawalQueueMinutes*Withdrawalqueueminutes
withdrawalProcessingQueueMinutes*Withdrawalprocessingqueueminutes
fullyWithdrawingValidators*Fullywithdrawingvalidators
partiallyWithdrawingValidators*Partiallywithdrawingvalidators
totalWithdrawingValidators*Totalwithdrawingvalidators
fullyWithdrawingBalance*Fullywithdrawingbalance
partiallyWithdrawingBalance*Partiallywithdrawingbalance
totalWithdrawingBalance*Totalwithdrawingbalance
exitingValidators*Exitingvalidators
exitingStakeExitingstake
liquidStakingPenetrationLiquidstakingpenetration
networkNativelyRestakedNetworknativelyrestaked
Request
const response = await fetch('/v0/eth/network/overview', {
    method: 'GET',
    headers: {},
});
const data = await response.json();
Response
[
  {
    "timeWindow": "all",
    "validatorCount": 513101,
    "validatorCountDiff": 0,
    "medianValidatorAgeDays": 446,
    "activeStake": 16419232000000000,
    "activeStakeDiff": 0,
    "avgValidatorBalance": 33989164381.593678,
    "avgValidatorBalanceDiff": 0,
    "consensusLayerRewardsPercentage": 71.00716294317242,
    "priorityFeesPercentage": 17.670898689999394,
    "baselineMevPercentage": 11.321938366828187,
    "avgValidatorEffectiveness": 96.24882777017207,
    "avgInclusionDelay": 1.026223700745488,
    "avgUptime": 99.60745479648561,
    "sumMissedSlots": 54305,
    "missedSlotsPercentage": 0.9463495357389193,
    "avgConsensusAprPercentage": 4.110372806103757,
    "avgExecutionAprPercentage": 1.8784786051796751,
    "medianConsensusAprPercentage": 3.892783165538195,
    "medianExecutionAprPercentage": 0.6112049138020833,
    "consensusRewardsRatio": 0.7100716294317242,
    "executionRewardsRatio": 0.2899283705682758,
    "avgNetworkAprPercentage": 5.988851411283433,
    "medianNetworkAprPercentage": 4.503988079340278,
    "avg_consensus_apr_gwei": 1315319298,
    "avg_execution_apr_gwei": 601113154,
    "median_consensus_apr_gwei": 1245690613,
    "median_execution_apr_gwei": 195585572,
    "avg_network_apr_gwei": 1916432452,
    "median_network_apr_gwei": 1441276185,
    "giniCoefficient": 0.9374772860811317,
    "clientPercentages": [
      {
        "client": "Lighthouse",
        "percentage": 0.3744886640155385
      },
      {
        "client": "Nimbus",
        "percentage": 0.025649007580706686
      },
      {
        "client": "Teku",
        "percentage": 0.19682653817317683
      },
      {
        "client": "Prysm",
        "percentage": 0.4004708894725073
      },
      {
        "client": "Lodestar",
        "percentage": 0.0025649007580706685
      }
    ],
    "clientValidatorEffectiveness": [
      {
        "client": "Lighthouse",
        "avgValidatorEffectiveness": 95.42
      },
      {
        "client": "Nimbus",
        "avgValidatorEffectiveness": 93.4
      },
      {
        "client": "Teku",
        "avgValidatorEffectiveness": 94.9
      }
    ],
    "latestEpoch": 162521,
    "activationQueueMinutes": 838.4,
    "activatingValidators": 787,
    "activatingStake": 25184000000000,
    "exitQueueMinutes": 25.6,
    "withdrawalQueueMinutes": 47392,
    "withdrawalProcessingQueueMinutes": 47834.2875,
    "fullyWithdrawingValidators": 32,
    "partiallyWithdrawingValidators": 35351,
    "totalWithdrawingValidators": 35383,
    "fullyWithdrawingBalance": 1024000000000,
    "partiallyWithdrawingBalance": 1447374543384832,
    "totalWithdrawingBalance": 39939418387645100,
    "exitingValidators": 98,
    "exitingStake": 3136000000000,
    "liquid_staking_penetration": 0.312321,
    "network_natively_restaked": 0.035343
  }
]

This endpoint returns a summary of key statistics for the whole network. The response gives you both the "All-time" aggregate, as well as the a paginated response on the averages of every day that precedes the current.

Network churn capacity

Get Network Churn Capacity

GET/v0/eth/network/capacity
Header parameters
Response

Successful Response

Body
timeWindow*TimeWindow

An enumeration.

1d7d30dall
latestEpoch*Latestepoch
activatedValidators*Activatedvalidators
activationCapacityFilled*Activationcapacityfilled
exitedValidators*Exitedvalidators
exitCapacityFilled*Exitcapacityfilled
activatedPercentage*Activatedpercentage
exitedPercentage*Exitedpercentage
churnLimit*Churnlimit
activationChurnLimit*Activationchurnlimit
exitChurnLimit*Exitchurnlimit
Request
const response = await fetch('/v0/eth/network/capacity', {
    method: 'GET',
    headers: {},
});
const data = await response.json();
Response
[
  {
    "time_window": "all",
    "latestEpoch": 186271,
    "activatedValidators": 238445,
    "activationCapacityFilled": 0.62372,
    "exitedValidators": 955,
    "exitCapacityFilled": 0.0025,
    "activatedPercentage": 0.47689,
    "exitedPercentage": 0.00191,
    "churnLimit": 382294,
    "activationChurnLimit": 382294,
    "exitChurnLimit": 382294
  }
]

This endpoint returns a summary of activations and exits for all the whole network. The response gives you both the "All-time" aggregate, as well as the a paginated response on the averages of every day that precedes the current.

Network churn capacity per pool

Get Network Churn Capacity Pool

GET/v0/eth/network/capacity/pool
Query parameters
Header parameters
Response

Successful Response

Body
timeWindow*TimeWindow

An enumeration.

1d7d30dall
stakeAction*StakeAction

An enumeration.

activationexit
latestEpoch*Latestepoch
churnLimit*Churnlimit
pool*Pool
validatorCount*Validatorcount
capacityFilled*Capacityfilled
networkCapacityRemaining*Networkcapacityremaining
Request
const response = await fetch('/v0/eth/network/capacity/pool', {
    method: 'GET',
    headers: {},
});
const data = await response.json();
Response
[
  {
    "time_window": "7d",
    "stakeAction": "activation",
    "latestEpoch": 187225,
    "churnLimit": 12600,
    "pool": "Lido",
    "validatorCount": 3534,
    "capacityFilled": 0.28048,
    "networkCapacityRemaining": 0.41198
  }
]

This endpoint returns a summary of activations and exits, broken down by staking pool.

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

ParameterContext

window

The time window of aggregation. You might ask for 1d, 7d, 30d or All-time data

stakeAction

Direction of flow. This can be either of activation or exit.

Last updated