Private Sets

Private sets is a self-serve feature designed to enable organizations to curate a set of validators, each marked with a unique tag. This tag, carrying an identifier specific to your organization, ensures that only you can view the performance and rewards metrics for it. Displayed within your console, these tags streamline analysis processes and let you perform A/B testing on your node setup or group together validators for a specific customer confidentially.

Getting Started

Build and Growth API users can create private sets. Build tier comes with max 4 sets while Growth comes with 20.

Step 1: Creating a Tag and associating validators to it

To call a set’s effectiveness, you must first create a tag which acts as a unique identifier for the set.

POST

Name	Type	Description
`name`	string	Name for the tag

Name	Type	Description
`pubkeys`	array	list of keys you wish to associate to a tag

Step 2: Calling the performance and rewards endpoints for your set

Using the tag’s ID, call the sets endpoints to retrieve performance and rewards metrics. These endpoints operate similar to the /operators/ endpoints with similar granularities and refresh windows.

Query parameters

Name	Type	Value
`granularity`	enum	`hour`or `day`
`fromDate`	date	the date from which you wish to retrieve the data
`toDate`	date	the date upto which you wish to retrieve the data
`limit`	integer	the number of rows returned per page
`offset`	integer	offset allows you to omit a specified number of rows before the beginning of the result set

Response

{
"pages": 3,
"results": [
    {
      "hour": null,
      "day": 796,
      "date": 2023-01-01,
      "startEpoch": 179324,
      "endEpoch": 179100,
      "validatorCount": 16075,
      "avgInclusionDelay": 1.0138705386457403,
      "avgUptime": 0.9999466390184881,
      "avgCorrectness": 0.9929917401071404,
      "avgProposerEffectiveness": 99.53271028037379,
      "avgValidatorEffectiveness": 97.96642775943795,
      "avgAttesterEffectiveness": 97.9580945527236
    }
  ],
  "previous": "string",
  "next": "string"
}

{
"pages": 3,
"results": [
    {
      "hour": null,
      "day": 796,
      "date": 2023-01-01,
      "startEpoch": 179324,
      "endEpoch": 179100,
      "validatorCount": 16075,
      "totalUniqueAttestations": 3616682,
      "sumMissedAttestations": 193,
      "sumMissedSyncSignatures": 2837,
      "sumCorrectHead": 3547355,
      "sumCorrectTarget": 3612248,
      "sumCorrectSource": 3614403,
      "sumWrongHeadVotes": 48767,
      "sumWrongTargetVotes": 4434,
      "sumWrongSourcetVotes": 4434,
      "sumLateSourceVotes": 2279,
      "sumLateTargetVotes": 0,
      "sumLateHeadVotes": 0,
      "avgAttesterEffectiveness": 97.9580945527236
    }
  ],
  "previous": "string",
  "next": "string"
}

{
"pages": 3,
"results": [
    {
      "hour": null,
      "day": 796,
      "date": 2023-01-01,
      "startEpoch": 179324,
      "endEpoch": 179100,
      "validatorCount": 16075,
      "sumProposedCount": 213,
      "sumProposerDutiesCount": 214,
      "avgProposerEffectiveness": 99.53271028037379
    }
  ],
  "previous": "string",
  "next": "string"
}

{
"pages": 3,
"results": [
    {
      "hour": null,
      "day": 796,
      "date": 2023-01-01,
      "startEpoch": 179324,
      "endEpoch": 179100,
      "validatorCount": 16075,
      "sumEarnings": 56766373292,
      "sumEstimatedRewards": 56675239144,
      "sumPriorityFees": 10662221791,
      "sumBaselineMev": 5266131924,
      "sumMissedExecutionRewards": 58181568,
      "sumConsensusBlockRewards": 6554423259,
      "sumMissedConsensusBlockRewards": 31228533,
      "sumAllRewards": 72694727007,
      "sumAttestationRewards": 50120815885,
      "sumMissedAttestationRewards": 269961427,
      "sumMissedSyncCommitteeRewards": 44317643,
      "sumExternallySourcedExecutionRewards": 14862131536
    }
  ],
  "previous": "string",
  "next": "string"
}

{
"pages": 3,
"results": [
    {
      "hour": null,
      "day": 796,
      "date": 2023-01-01,
      "startEpoch": 179324,
      "endEpoch": 179100,
      "validatorCount": 16075,
      "sumEstimatedPenalties": -82967688,
      "sumSyncCommitteePenalties": -44317643,
      "sumWrongTargetPenalties": -28763358,
      "sumLateTargetPenalties": 0,
      "sumMissedAttestationPenalties": -1926140,
      "sumWrongHeadPenalties": 0,
      "sumLateSourcePenalties": -7960547
    }
  ],
  "previous": "string",
  "next": "string"
}

Getting started

Rated API

Endpoints

Glossary

Guides

Tools

Getting Started

Step 1: Creating a Tag and associating validators to it

Step 2: Calling the performance and rewards endpoints for your set

​Getting Started

​Step 1: Creating a Tag and associating validators to it

​Step 2: Calling the performance and rewards endpoints for your set

Getting Started

Step 1: Creating a Tag and associating validators to it

Step 2: Calling the performance and rewards endpoints for your set