P2P (beta)

Querying into aggregate stats on Ethereum's peer-to-peer networking layer

These endpoints are still in beta. If you spot inconsistencies or unexpected results, please get in touch via [e-mail] or under #product-feedback in our Discord.

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.

Geographic Distribution

Get P2P Geographical Distribution

GET/v0/eth/p2p/geographical

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

country*Country

countryCode*Countrycode

validatorShare*Validatorshare

distType*DistType

An enumeration.

allpros

Request

JavaScriptCurlPython

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

Response

200400

[
  {
    "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 distType, this can the market share based on all the validators or just those are being run by professional entities.

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

Parameter	Context
distType	The type of distribution. This can either be all or pros.

Our definition of professional entities is largely based off our work on classifying solo stakers in the Ethereum validator set.

Hosting Provider Distribution

Get P2P Hosting Provider Distribution

GET/v0/eth/p2p/hostingProvider

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

page*PageP2P

total*Total

data*Data

nextNext

Request

JavaScriptCurlPython

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

Response

200400

{
  "page": {
    "fromRank": 0,
    "toRank": 0,
    "size": 10
  },
  "total": 0,
  "data": [
    {
      "hosting_provider": "AWS",
      "validator_share": 0.5,
      "dist_type": "pros"
    }
  ],
  "next": "text"
}

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

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

Parameter	Context
distType	The type of distribution. This can either be all or pros.