Network

A series of endpoints that provide network-level metrics about performance, rewards, and distributions.

Network Overview Endpoint

These endpoints allow querying into a collection of stats 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 https://explorer.rated.network/network?network=mainnet

Get an overview of the Ethereum network.

This endpoint returns a network-wide overview of Ethereum.

GET/v1/eth

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurl

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

Response

{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "window": "1d",
      "validatorCount": 37361,
      "validatorCountDiff": 37361,
      "medianValidatorAgeDays": 37361,
      "activeStake": 37361,
      "activeStakeDiff": 37361,
      "avgValidatorBalance": 37361,
      "avgValidatorBalanceDiff": 37361,
      "sumMissedSlots": 37361,
      "missedSlotsPercentage": 0.07855633469653803,
      "avgValidatorEffectiveness": 0.07855633469653803,
      "giniCoefficient": 0.07855633469653803,
      "clientPercentages": [
        {
          "client": "Prysm",
          "percentage": 0.5
        },
        {
          "client": "Lighthouse",
          "percentage": 0.3
        }
      ]
    }
  ]
}

Network Performance Endpoint

Get an overview of the Ethereum performance.

This endpoint returns a network-wide overview of Ethereum performance metrics.

GET/v1/eth/effectiveness

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurl

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

Response

{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "window": "1d",
      "validatorCount": 37361,
      "avgValidatorEffectiveness": 0.07855633469653803,
      "avgInclusionDelay": 0.07855633469653803,
      "avgUptime": 0.07855633469653803,
      "clientValidatorEffectiveness": [
        {
          "client": "Prysm",
          "effectiveness": 0.5
        },
        {
          "client": "Lighthouse",
          "effectiveness": 0.3
        }
      ]
    }
  ]
}

Network Rewards Endpoint

Get reward metrics of the Ethereum network.

This endpoint returns a network-wide overview of Ethereum reward metrics.

GET/v1/eth/rewards

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurl

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

Response

{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "timeWindow": "1d",
      "consensusLayerRewardsPercentage": 0.07855633469653803,
      "priorityFeesPercentage": 0.07855633469653803,
      "baselineMevPercentage": 0.07855633469653803,
      "avgConsensusAprPercentage": 0.07855633469653803,
      "avgExecutionAprPercentage": 0.07855633469653803,
      "medianConsensusAprPercentage": 0.07855633469653803,
      "medianExecutionAprPercentage": 0.07855633469653803,
      "consensusRewardsRatio": 0.07855633469653803,
      "executionRewardsRatio": 0.07855633469653803,
      "avgNetworkAprPercentage": 0.07855633469653803,
      "medianNetworkAprPercentage": 0.07855633469653803,
      "avgConsensusAprGwei": 37361,
      "avgExecutionAprGwei": 37361,
      "medianConsensusAprGwei": 37361,
      "medianExecutionAprGwei": 37361,
      "avgNetworkAprGwei": 37361,
      "medianNetworkAprGwei": 37361,
      "giniCoefficient": 0.07855633469653803
    }
  ]
}

Geo and Host Distribution P2P Endpoints

The P2P endpoints give a view into the Ethereum Beacon Chain's peer-to-peer networking layer. Using our in-house peer-to-peer probe, we are able to pinpoint IP addresses of nodes, and resolve those addresses to their geographical locations and other network metadata.

Get the geographical distribution of the Ethereum network.

This endpoint returns information about the geographical distribution of validators in Ethereum.

GET/v1/eth/geographicalDistributions

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurl

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

Response

{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "country": "United States",
      "country_code": "US",
      "validator_share": 0.5,
      "dist_type": "pros"
    }
  ]
}

This endpoint gives a list of countries and the respective share of the validator set based in those countries. Depending on the input to distributionType, this can the market share based on all the validators or just those are being run by professional entities.

Get the host distribution of the Ethereum network.

This endpoint returns information about the host distribution of validators in Ethereum.

GET/v1/eth/hostDistributions

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurl

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

Response

{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "hosting_provider": "AWS",
      "validator_share": 0.5,
      "dist_type": "pros"
    }
  ]
}

This endpoint gives a list of hosting providers and their respective share of the validator set. Depending on the input to distributionType, this can the market share based on all the validators or just those are being run by professional entities.