Performance Benchmarking
Last updated
Last updated
Performance benchmarking is a critical practice that involves evaluating and comparing the efficiency of various validators, both internal and external, to find areas of efficiency. Rated APIs provide access to standardized performance metrics, which can be used by:
Node Operators to continuously monitor their own performance metrics in relation to their competitors. This not only helps in identifying areas of improvement but also facilitates the formulation of effective strategies to enhance their operational efficiency and service quality.
Custodians and Centralised Exchanges to conduct thorough evaluations of validator operators, comparing their performance against network standards and other validators. This comprehensive analysis assists in making strategic decisions regarding SLAs and pricing, ensuring optimal performance and cost-effectiveness.
Sign into the Rated Console to generate your API Tokn.
The Rated API offers time window aggregation, allowing you to consolidate data over various time periods such as day
, week
, month
, quarter
, year
or all time
. You can retrieve reward info in two ways:
Pre-materialized views
Specific validator groups
Imagine you're Kiln (a Node Operator), Lido (a Pool), or Coinbase (an Exchange). You want all your reward details (consensus layer and execution layer including penalties) for August 2023, shown daily. Here's how you'd go about getting this data.
Call the endpoint with the following parameters set:
operator_id
Yes
string
idType
Yes
string
The type of entity class you would like returned. You might ask for pool
, poolShare
, nodeOperator
, depositAddress
, or withdrawalAddress
.
Note: it is optional and can be inferred automatically for pools, pool shares and node operators. It defaults to depositAddress
if it is missing and an address is provided.
granularity
Yes
string
The size of time increments you are looking to query. Can be day
/ week
/ month
/ quarter
/ year
.
For this example, you should set granularity to day
.
from
Yes
string
Start day (integer) or date (e.g. from=“2022-12-01”)
For this example, set from to 2023-08-31
size
Yes
integer
The number of results included per page. For this example, you should set size as 31 as we want the monthly data for August 2023.
filterType
Yes
string
hour
, day
and datetime
For this example, set to datetime
include
Yes
array
A list of field names.
To get the performance data, you should include the following data: day
,
validatorCount
, avgInclusionDelay
, avgUptime
, avgCorrectness
, avgProposerEffectiveness
, avgValidatorEffectiveness
, avgAttesterEffectiveness
,sumCorrectHead
, sumCorrectTarget
, sumCorrectSource
,sumInclusionDelay
, sumProposedCount
, sumProposerDutiesCount
, slashesCollected
, slashesReceived
, sumMissedSyncSignatures
, sumLateSourceVotes
, sumWrongTargetVotes
, sumLateTargetVotes
, sumMissedAttestations
, sumWrongHeadVotes
, sumExecutionProposedEmptyCount
# Example: Obtaining daily performance metrics for the month of August 2023 for Kiln
curl -v -X 'GET' \
'https://api.rated.network/v0/eth/operators/Kiln/effectiveness?from=2023-08-31&size=31&granularity=day&filterType=datetime&include=validatorCount&include=avgInclusionDelay&include=avgUptime&include=avgCorrectness&include=avgProposerEffectiveness&include=avgValidatorEffectiveness&include=avgAttesterEffectiveness&include=sumCorrectHead&include=sumCorrectTarget&include=sumCorrectSource&include=sumInclusionDelay&include=sumProposedCount&include=sumProposerDutiesCount&include=sumLateTargetPenalties&include=slashesCollected&include=slashesReceived&idType=nodeOperator&include=day&include=sumMissedSyncSignatures&include=sumLateSourceVotes&include=sumWrongTargetVotes&include=sumMissedAttestations&include=sumWrongHeadVotes&include=sumLateTargetVotes&include=sumMissedAttestations&include=sumWrongHeadVotes&include=sumExecutionProposedEmptyCount' \
-H 'Content-Type: application/json' \
-H 'X-Rated-Network: mainnet' \
-H 'Authorization: Bearer <YOUR-TOKEN-HERE>'
import requests
url = "https://api.rated.network/v0/eth/operators/Kiln/effectiveness"
params = {
"from": "2023-08-31",
"size": 31,
"granularity": "day",
"filterType": "datetime",
"include": [
"validatorCount",
"avgInclusionDelay",
"avgUptime",
"avgCorrectness",
"avgProposerEffectiveness",
"avgValidatorEffectiveness",
"avgAttesterEffectiveness",
"sumCorrectHead",
"sumCorrectTarget",
"sumCorrectSource",
"sumInclusionDelay",
"sumProposedCount",
"sumProposerDutiesCount",
"sumLateTargetPenalties",
"slashesCollected",
"slashesReceived",
"day",
"sumMissedSyncSignatures",
"sumLateSourceVotes",
"sumWrongTargetVotes",
"sumMissedAttestations",
"sumWrongHeadVotes",
"sumLateTargetVotes",
"sumExecutionProposedEmptyCount"
],
"idType": "nodeOperator"
}
headers = {
"Content-Type": "application/json",
"X-Rated-Network": "mainnet",
"Authorization": "Bearer <YOUR-TOKEN-HERE>"
}
response = requests.get(url, params=params, headers=headers)
print(response.json())
You will get the following response:
{
"page": {
"from": "2023-08-31",
"to": null,
"size": 31,
"granularity": "day",
"filterType": "datetime"
},
"total": 914,
"data": [
{
"day": 1003,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 26352,
"avgInclusionDelay": 1.0188368770048535,
"avgUptime": 0.9997140823592084,
"avgCorrectness": 0.994994287745444,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 97.68045681275501,
"sumCorrectHead": 5849471,
"sumCorrectTarget": 5915627,
"sumInclusionDelay": 6036534.0,
"sumProposedCount": 265,
"sumProposerDutiesCount": 265,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5920766,
"avgAttesterEffectiveness": 97.67223143161515,
"sumMissedSyncSignatures": 2257,
"sumLateSourceVotes": 4177,
"sumWrongTargetVotes": 9316,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 1695,
"sumWrongHeadVotes": 31032,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 1002,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 26304,
"avgInclusionDelay": 1.0220451909778872,
"avgUptime": 0.999241789828051,
"avgCorrectness": 0.9953524351155809,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 97.37819858816198,
"sumCorrectHead": 5825693,
"sumCorrectTarget": 5891063,
"sumInclusionDelay": 6026065.0,
"sumProposedCount": 275,
"sumProposerDutiesCount": 275,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5889196,
"avgAttesterEffectiveness": 97.36756921537427,
"sumMissedSyncSignatures": 1958,
"sumLateSourceVotes": 6862,
"sumWrongTargetVotes": 4991,
"sumLateTargetVotes": 4,
"sumLateTargetPenalties": -21268.0,
"sumMissedAttestations": 4481,
"sumWrongHeadVotes": 22824,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 1001,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 26032,
"avgInclusionDelay": 1.0215570977267951,
"avgUptime": 0.999235648830497,
"avgCorrectness": 0.9945644864072727,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 97.33039001604078,
"sumCorrectHead": 5766739,
"sumCorrectTarget": 5840230,
"sumInclusionDelay": 5974628.0,
"sumProposedCount": 255,
"sumProposerDutiesCount": 255,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5843203,
"avgAttesterEffectiveness": 97.32096742948768,
"sumMissedSyncSignatures": 2169,
"sumLateSourceVotes": 5316,
"sumWrongTargetVotes": 8289,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 4473,
"sumWrongHeadVotes": 29864,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 1000,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 25990,
"avgInclusionDelay": 1.0263167700659548,
"avgUptime": 0.9997159116819724,
"avgCorrectness": 0.994319483853984,
"avgProposerEffectiveness": 99.7011952191235,
"avgValidatorEffectiveness": 96.91191842640409,
"sumCorrectHead": 5754131,
"sumCorrectTarget": 5836250,
"sumInclusionDelay": 5994200.0,
"sumProposedCount": 252,
"sumProposerDutiesCount": 252,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5831636,
"avgAttesterEffectiveness": 96.90159687310516,
"sumMissedSyncSignatures": 1360,
"sumLateSourceVotes": 8874,
"sumWrongTargetVotes": 4260,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 1661,
"sumWrongHeadVotes": 24798,
"sumExecutionProposedEmptyCount": 1
},
{
"day": 999,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 25945,
"avgInclusionDelay": 1.0234147785939507,
"avgUptime": 0.9994261943586022,
"avgCorrectness": 0.9941376822826933,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 97.14156415279751,
"sumCorrectHead": 5725500,
"sumCorrectTarget": 5815918,
"sumInclusionDelay": 5955392.0,
"sumProposedCount": 243,
"sumProposerDutiesCount": 243,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5813299,
"avgAttesterEffectiveness": 97.13182613004619,
"sumMissedSyncSignatures": 1803,
"sumLateSourceVotes": 5752,
"sumWrongTargetVotes": 3133,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 3331,
"sumWrongHeadVotes": 43631,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 998,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 25829,
"avgInclusionDelay": 1.0195514659856697,
"avgUptime": 0.9995925692065383,
"avgCorrectness": 0.9921031035736148,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 97.31728310996066,
"sumCorrectHead": 5675856,
"sumCorrectTarget": 5796798,
"sumInclusionDelay": 5916521.0,
"sumProposedCount": 245,
"sumProposerDutiesCount": 245,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5799053,
"avgAttesterEffectiveness": 97.3077974307106,
"sumMissedSyncSignatures": 2841,
"sumLateSourceVotes": 3991,
"sumWrongTargetVotes": 6246,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 2364,
"sumWrongHeadVotes": 87558,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 997,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 25697,
"avgInclusionDelay": 1.0264666332203236,
"avgUptime": 0.9998234301120685,
"avgCorrectness": 0.9943121179788222,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 96.91157707005048,
"sumCorrectHead": 5611871,
"sumCorrectTarget": 5695602,
"sumInclusionDelay": 5849433.0,
"sumProposedCount": 239,
"sumProposerDutiesCount": 239,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5691970,
"avgAttesterEffectiveness": 96.90050356489697,
"sumMissedSyncSignatures": 2872,
"sumLateSourceVotes": 6930,
"sumWrongTargetVotes": 3298,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 931,
"sumWrongHeadVotes": 22301,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 996,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 25285,
"avgInclusionDelay": 1.0197150474320078,
"avgUptime": 0.9997809202731148,
"avgCorrectness": 0.9957322486776318,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 97.66945581377658,
"sumCorrectHead": 5618623,
"sumCorrectTarget": 5680666,
"sumInclusionDelay": 5795309.0,
"sumProposedCount": 261,
"sumProposerDutiesCount": 261,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5677569,
"avgAttesterEffectiveness": 97.66117395728182,
"sumMissedSyncSignatures": 1859,
"sumLateSourceVotes": 5629,
"sumWrongTargetVotes": 2532,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 1246,
"sumWrongHeadVotes": 15448,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 995,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 25254,
"avgInclusionDelay": 1.0199780273053674,
"avgUptime": 0.9999413954225083,
"avgCorrectness": 0.9955257619747856,
"avgProposerEffectiveness": 99.609375,
"avgValidatorEffectiveness": 97.63207176588406,
"sumCorrectHead": 5598745,
"sumCorrectTarget": 5665448,
"sumInclusionDelay": 5781337.0,
"sumProposedCount": 255,
"sumProposerDutiesCount": 256,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5664512,
"avgAttesterEffectiveness": 97.62498439545334,
"sumMissedSyncSignatures": 1515,
"sumLateSourceVotes": 3724,
"sumWrongTargetVotes": 2788,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 333,
"sumWrongHeadVotes": 15535,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 994,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 25187,
"avgInclusionDelay": 1.0251886314840208,
"avgUptime": 0.9996530838219013,
"avgCorrectness": 0.9950405041614591,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 97.08525362515735,
"sumCorrectHead": 5587175,
"sumCorrectTarget": 5653430,
"sumInclusionDelay": 5800704.0,
"sumProposedCount": 216,
"sumProposerDutiesCount": 216,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5650080,
"avgAttesterEffectiveness": 97.0765919452766,
"sumMissedSyncSignatures": 1535,
"sumLateSourceVotes": 8203,
"sumWrongTargetVotes": 4853,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 1966,
"sumWrongHeadVotes": 18418,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 993,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 25129,
"avgInclusionDelay": 1.0218750990095244,
"avgUptime": 0.9998005893982649,
"avgCorrectness": 0.9948222044519789,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 97.38076613958853,
"sumCorrectHead": 5568547,
"sumCorrectTarget": 5636428,
"sumInclusionDelay": 5766774.0,
"sumProposedCount": 231,
"sumProposerDutiesCount": 231,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5637027,
"avgAttesterEffectiveness": 97.3712831954191,
"sumMissedSyncSignatures": 1488,
"sumLateSourceVotes": 6214,
"sumWrongTargetVotes": 6813,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 1126,
"sumWrongHeadVotes": 20391,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 992,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 25043,
"avgInclusionDelay": 1.0268110818055882,
"avgUptime": 0.9994429712142497,
"avgCorrectness": 0.9937315062276405,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 96.79146709074645,
"sumCorrectHead": 5516805,
"sumCorrectTarget": 5610986,
"sumInclusionDelay": 5762515.0,
"sumProposedCount": 220,
"sumProposerDutiesCount": 220,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5602972,
"avgAttesterEffectiveness": 96.78026663120795,
"sumMissedSyncSignatures": 2594,
"sumLateSourceVotes": 9121,
"sumWrongTargetVotes": 1107,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 3131,
"sumWrongHeadVotes": 37020,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 991,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 24589,
"avgInclusionDelay": 1.0251684866986839,
"avgUptime": 0.9996418718961864,
"avgCorrectness": 0.9935358008292835,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 96.93127027989108,
"sumCorrectHead": 5422285,
"sumCorrectTarget": 5518482,
"sumInclusionDelay": 5659937.0,
"sumProposedCount": 237,
"sumProposerDutiesCount": 237,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5515341,
"avgAttesterEffectiveness": 96.92135153453688,
"sumMissedSyncSignatures": 1819,
"sumLateSourceVotes": 5680,
"sumWrongTargetVotes": 2535,
"sumLateTargetVotes": 4,
"sumLateTargetPenalties": -21632.0,
"sumMissedAttestations": 1972,
"sumWrongHeadVotes": 38501,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 990,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 24543,
"avgInclusionDelay": 1.0186973019618306,
"avgUptime": 0.9997953750598717,
"avgCorrectness": 0.9947277564128169,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 97.6645502934379,
"sumCorrectHead": 5428229,
"sumCorrectTarget": 5504249,
"sumInclusionDelay": 5611195.0,
"sumProposedCount": 236,
"sumProposerDutiesCount": 236,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5505004,
"avgAttesterEffectiveness": 97.6554035117029,
"sumMissedSyncSignatures": 1142,
"sumLateSourceVotes": 3192,
"sumWrongTargetVotes": 3947,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 1120,
"sumWrongHeadVotes": 30508,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 989,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 24448,
"avgInclusionDelay": 1.0218878279406551,
"avgUptime": 0.9997980293775451,
"avgCorrectness": 0.9948776552380003,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 97.38586489327326,
"sumCorrectHead": 5410039,
"sumCorrectTarget": 5479529,
"sumInclusionDelay": 5604782.0,
"sumProposedCount": 261,
"sumProposerDutiesCount": 261,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5480159,
"avgAttesterEffectiveness": 97.37597862071881,
"sumMissedSyncSignatures": 1921,
"sumLateSourceVotes": 4504,
"sumWrongTargetVotes": 5134,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 1111,
"sumWrongHeadVotes": 19266,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 988,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 24309,
"avgInclusionDelay": 1.0165571943598193,
"avgUptime": 0.9999029301598028,
"avgCorrectness": 0.9950154164592522,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 97.90224550597397,
"sumCorrectHead": 5373922,
"sumCorrectTarget": 5434670,
"sumInclusionDelay": 5534448.0,
"sumProposedCount": 226,
"sumProposerDutiesCount": 226,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5442564,
"avgAttesterEffectiveness": 97.89539511048454,
"sumMissedSyncSignatures": 1465,
"sumLateSourceVotes": 1633,
"sumWrongTargetVotes": 9524,
"sumLateTargetVotes": 3,
"sumLateTargetPenalties": -16263.0,
"sumMissedAttestations": 529,
"sumWrongHeadVotes": 20122,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 987,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 24157,
"avgInclusionDelay": 1.0148472005062954,
"avgUptime": 0.9998893965304537,
"avgCorrectness": 0.9960894509717636,
"avgProposerEffectiveness": 99.56521739130434,
"avgValidatorEffectiveness": 98.16680207507882,
"sumCorrectHead": 5365000,
"sumCorrectTarget": 5416428,
"sumInclusionDelay": 5502778.0,
"sumProposedCount": 233,
"sumProposerDutiesCount": 234,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5421789,
"avgAttesterEffectiveness": 98.16279987944391,
"sumMissedSyncSignatures": 973,
"sumLateSourceVotes": 478,
"sumWrongTargetVotes": 5839,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 601,
"sumWrongHeadVotes": 14302,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 986,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 24094,
"avgInclusionDelay": 1.0127740767535351,
"avgUptime": 0.9999462742636024,
"avgCorrectness": 0.9964409520054426,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 98.40987435990161,
"sumCorrectHead": 5348538,
"sumCorrectTarget": 5396114,
"sumInclusionDelay": 5468615.0,
"sumProposedCount": 242,
"sumProposerDutiesCount": 242,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5397137,
"avgAttesterEffectiveness": 98.40402211259011,
"sumMissedSyncSignatures": 1195,
"sumLateSourceVotes": 2648,
"sumWrongTargetVotes": 3671,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 289,
"sumWrongHeadVotes": 18002,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 985,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 23937,
"avgInclusionDelay": 1.0226348334128628,
"avgUptime": 0.999568980031539,
"avgCorrectness": 0.9929901715872753,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 97.1179935895044,
"sumCorrectHead": 5265607,
"sumCorrectTarget": 5363729,
"sumInclusionDelay": 5490118.0,
"sumProposedCount": 227,
"sumProposerDutiesCount": 227,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5363195,
"avgAttesterEffectiveness": 97.10825470759872,
"sumMissedSyncSignatures": 2629,
"sumLateSourceVotes": 5308,
"sumWrongTargetVotes": 4774,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 2310,
"sumWrongHeadVotes": 55127,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 984,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 23821,
"avgInclusionDelay": 1.0182046147318047,
"avgUptime": 0.9999085483238356,
"avgCorrectness": 0.9945015202378422,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 97.69942173298807,
"sumCorrectHead": 5264658,
"sumCorrectTarget": 5341818,
"sumInclusionDelay": 5442698.0,
"sumProposedCount": 220,
"sumProposerDutiesCount": 220,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5341472,
"avgAttesterEffectiveness": 97.69101012988752,
"sumMissedSyncSignatures": 1188,
"sumLateSourceVotes": 3898,
"sumWrongTargetVotes": 3551,
"sumLateTargetVotes": 1,
"sumLateTargetPenalties": -5460.0,
"sumMissedAttestations": 488,
"sumWrongHeadVotes": 36950,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 983,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 23693,
"avgInclusionDelay": 1.0252909496455278,
"avgUptime": 0.9997028403185192,
"avgCorrectness": 0.9949580636936718,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 97.09015271346662,
"sumCorrectHead": 5247522,
"sumCorrectTarget": 5311037,
"sumInclusionDelay": 5450642.0,
"sumProposedCount": 243,
"sumProposerDutiesCount": 243,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5310028,
"avgAttesterEffectiveness": 97.07863489881677,
"sumMissedSyncSignatures": 1212,
"sumLateSourceVotes": 6288,
"sumWrongTargetVotes": 5279,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 1566,
"sumWrongHeadVotes": 19930,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 982,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 23604,
"avgInclusionDelay": 1.015468485079651,
"avgUptime": 0.9998902257621117,
"avgCorrectness": 0.9956187655362255,
"avgProposerEffectiveness": 99.6987951807229,
"avgValidatorEffectiveness": 98.06332422483759,
"sumCorrectHead": 5239991,
"sumCorrectTarget": 5299345,
"sumInclusionDelay": 5385724.0,
"sumProposedCount": 250,
"sumProposerDutiesCount": 250,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5302074,
"avgAttesterEffectiveness": 98.05661185892909,
"sumMissedSyncSignatures": 2170,
"sumLateSourceVotes": 1624,
"sumWrongTargetVotes": 4353,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 583,
"sumWrongHeadVotes": 21993,
"sumExecutionProposedEmptyCount": 1
},
{
"day": 981,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 23556,
"avgInclusionDelay": 1.0213552613246493,
"avgUptime": 0.9998846810961218,
"avgCorrectness": 0.9949693754715468,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 97.45722753321698,
"sumCorrectHead": 5210426,
"sumCorrectTarget": 5271486,
"sumInclusionDelay": 5391335.0,
"sumProposedCount": 234,
"sumProposerDutiesCount": 234,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5273965,
"avgAttesterEffectiveness": 97.44738005999723,
"sumMissedSyncSignatures": 1290,
"sumLateSourceVotes": 4562,
"sumWrongTargetVotes": 7032,
"sumLateTargetVotes": 9,
"sumLateTargetPenalties": -49374.0,
"sumMissedAttestations": 607,
"sumWrongHeadVotes": 21767,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 980,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 23248,
"avgInclusionDelay": 1.0220131990012111,
"avgUptime": 0.9997791924753382,
"avgCorrectness": 0.9935143734118197,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 97.24073077987238,
"sumCorrectHead": 5137315,
"sumCorrectTarget": 5220740,
"sumInclusionDelay": 5342196.0,
"sumProposedCount": 206,
"sumProposerDutiesCount": 206,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5221609,
"avgAttesterEffectiveness": 97.23071933695259,
"sumMissedSyncSignatures": 1356,
"sumLateSourceVotes": 5514,
"sumWrongTargetVotes": 6355,
"sumLateTargetVotes": 28,
"sumLateTargetPenalties": -153608.0,
"sumMissedAttestations": 1155,
"sumWrongHeadVotes": 42222,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 979,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 23236,
"avgInclusionDelay": 1.019260478401074,
"avgUptime": 0.9998458905212464,
"avgCorrectness": 0.9944376134873905,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 97.5984433316195,
"sumCorrectHead": 5132484,
"sumCorrectTarget": 5197822,
"sumInclusionDelay": 5306744.0,
"sumProposedCount": 238,
"sumProposerDutiesCount": 238,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5202089,
"avgAttesterEffectiveness": 97.58900463878165,
"sumMissedSyncSignatures": 1398,
"sumLateSourceVotes": 4330,
"sumWrongTargetVotes": 8597,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 804,
"sumWrongHeadVotes": 25120,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 978,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 23035,
"avgInclusionDelay": 1.024171239449948,
"avgUptime": 0.9996940479111284,
"avgCorrectness": 0.993292501585967,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 97.02727324870222,
"sumCorrectHead": 5080824,
"sumCorrectTarget": 5166664,
"sumInclusionDelay": 5297079.0,
"sumProposedCount": 229,
"sumProposerDutiesCount": 229,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5164963,
"avgAttesterEffectiveness": 97.01636750320873,
"sumMissedSyncSignatures": 2088,
"sumLateSourceVotes": 7222,
"sumWrongTargetVotes": 5521,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 1582,
"sumWrongHeadVotes": 48669,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 977,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 22959,
"avgInclusionDelay": 1.0182616401826303,
"avgUptime": 0.999845046220374,
"avgCorrectness": 0.9941968175289687,
"avgProposerEffectiveness": 99.65753424657534,
"avgValidatorEffectiveness": 97.66666622600285,
"sumCorrectHead": 5019476,
"sumCorrectTarget": 5096171,
"sumInclusionDelay": 5193670.0,
"sumProposedCount": 219,
"sumProposerDutiesCount": 219,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5096722,
"avgAttesterEffectiveness": 97.65981565238637,
"sumMissedSyncSignatures": 2075,
"sumLateSourceVotes": 3678,
"sumWrongTargetVotes": 4229,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 798,
"sumWrongHeadVotes": 40881,
"sumExecutionProposedEmptyCount": 1
},
{
"day": 976,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 22590,
"avgInclusionDelay": 1.014642378578903,
"avgUptime": 0.9999003882933705,
"avgCorrectness": 0.9955280695479524,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 98.1363493744098,
"sumCorrectHead": 5013137,
"sumCorrectTarget": 5070627,
"sumInclusionDelay": 5148815.0,
"sumProposedCount": 231,
"sumProposerDutiesCount": 231,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5072666,
"avgAttesterEffectiveness": 98.12866244693858,
"sumMissedSyncSignatures": 1146,
"sumLateSourceVotes": 2119,
"sumWrongTargetVotes": 4158,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 505,
"sumWrongHeadVotes": 22716,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 975,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 22538,
"avgInclusionDelay": 1.0150452469391984,
"avgUptime": 0.9998696522416458,
"avgCorrectness": 0.9951239066005826,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 98.0531299905963,
"sumCorrectHead": 4990771,
"sumCorrectTarget": 5051467,
"sumInclusionDelay": 5133419.0,
"sumProposedCount": 223,
"sumProposerDutiesCount": 223,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5055572,
"avgAttesterEffectiveness": 98.04597660589073,
"sumMissedSyncSignatures": 839,
"sumLateSourceVotes": 1688,
"sumWrongTargetVotes": 5793,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 661,
"sumWrongHeadVotes": 24207,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 974,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 22476,
"avgInclusionDelay": 1.0138119160724395,
"avgUptime": 0.9998665242925783,
"avgCorrectness": 0.996160590347952,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 98.27332028068615,
"sumCorrectHead": 4996773,
"sumCorrectTarget": 5041591,
"sumInclusionDelay": 5116963.0,
"sumProposedCount": 231,
"sumProposerDutiesCount": 231,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5045259,
"avgAttesterEffectiveness": 98.26690047768027,
"sumMissedSyncSignatures": 800,
"sumLateSourceVotes": 2004,
"sumWrongTargetVotes": 5672,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 675,
"sumWrongHeadVotes": 16057,
"sumExecutionProposedEmptyCount": 0
},
{
"day": 973,
"id": "Kiln",
"idType": "nodeOperator",
"validatorCount": 22438,
"avgInclusionDelay": 1.012646256292743,
"avgUptime": 0.9997943561599755,
"avgCorrectness": 0.9968072887738811,
"avgProposerEffectiveness": 100.0,
"avgValidatorEffectiveness": 98.44135836095637,
"sumCorrectHead": 4994871,
"sumCorrectTarget": 5034126,
"sumInclusionDelay": 5101280.0,
"sumProposedCount": 217,
"sumProposerDutiesCount": 217,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 5035511,
"avgAttesterEffectiveness": 98.43524527816203,
"sumMissedSyncSignatures": 1798,
"sumLateSourceVotes": 2076,
"sumWrongTargetVotes": 3461,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 1038,
"sumWrongHeadVotes": 13443,
"sumExecutionProposedEmptyCount": 0
}
],
"next": "/v0/eth/operators/Kiln/effectiveness?from=2023-07-31&size=31&granularity=day&filterType=datetime&include=validatorCount&include=avgInclusionDelay&include=avgUptime&include=avgCorrectness&include=avgProposerEffectiveness&include=avgValidatorEffectiveness&include=avgAttesterEffectiveness&include=sumCorrectHead&include=sumCorrectTarget&include=sumCorrectSource&include=sumInclusionDelay&include=sumProposedCount&include=sumProposerDutiesCount&include=sumLateTargetPenalties&include=slashesCollected&include=slashesReceived&include=day&include=sumMissedSyncSignatures&include=sumLateSourceVotes&include=sumWrongTargetVotes&include=sumMissedAttestations&include=sumWrongHeadVotes&include=sumLateTargetVotes&include=sumMissedAttestations&include=sumWrongHeadVotes&include=sumExecutionProposedEmptyCount&idType=nodeOperator"
}
pubkeys (OR) indices
Yes
array [string] (OR) array [integer]
Array of validator pubkeys or indicies you're performing the grouped analysis for. For this example, you should put indices as 675893
675894
and
filterType
Yes
string
hour
, day
and datetime
For this example, set to datetime
from
Yes
string
The most recent date for your desired timeline. In this example, it is 2023-08-31
size
Yes
integer
The number of results included per page. For this example, you should set size as 31 as we want the monthly data for August 2023.
granularity
Yes
string
The size of time increments you are looking to query. Can be day
/ week
/ month
/ quarter
/ year
.
For this example, set granularity to day
.
groupBy
Yes
string
Aggregation groupings. Can be timeWindow
if you'd like to aggregation for your desired time window or validator
if you'd like it per validator.
For this example, set it to timeWindow
.
include
Yes
array [string]
A list of field names.
To get the performance data, you should include the following data: day
,
validatorCount
, avgInclusionDelay
, avgUptime
, avgCorrectness
, avgProposerEffectiveness
, avgValidatorEffectiveness
, avgAttesterEffectiveness
,sumCorrectHead
, sumCorrectTarget
, sumCorrectSource
,sumInclusionDelay
, sumProposedCount
, sumProposerDutiesCount
, slashesCollected
, slashesReceived
, sumMissedSyncSignatures
, sumLateSourceVotes
, sumWrongTargetVotes
, sumLateTargetVotes
, sumMissedAttestations
, sumWrongHeadVotes
, sumExecutionProposedEmptyCount
# Example: Obtaining daily performance metrics for the month of August 2023 for Validator group {675893,675894,675895}
curl -v -X 'GET' \
'https://api.rated.network/v0/eth/validators/effectiveness?from=2023-08-31&size=31&granularity=day&filterType=datetime&include=validatorCount&include=avgInclusionDelay&include=avgUptime&include=avgCorrectness&include=avgProposerEffectiveness&include=avgValidatorEffectiveness&include=avgAttesterEffectiveness&include=sumCorrectHead&include=sumCorrectTarget&include=sumCorrectSource&include=sumInclusionDelay&include=sumProposedCount&include=sumProposerDutiesCount&include=sumLateTargetPenalties&include=slashesCollected&include=slashesReceived&include=day&include=sumMissedSyncSignatures&include=sumLateSourceVotes&include=sumWrongTargetVotes&include=sumMissedAttestations&include=sumWrongHeadVotes&include=sumLateTargetVotes&include=sumMissedAttestations&include=sumWrongHeadVotes&include=sumExecutionProposedEmptyCount&indices=675893&indices=675894&indices=675895&groupBy=timeWindow' \
-H 'Content-Type: application/json' \
-H 'X-Rated-Network: mainnet' \
-H 'Authorization: Bearer <YOUR-TOKEN-HERE>'
import requests
url = "https://api.rated.network/v0/eth/validators/effectiveness"
params = {
"indices": [675893, 675894, 675895],
"granularity": "day",
"from": "2023-08-31",
"size": 31,
"filterType": "datetime",
"groupBy": "timeWindow",
"include": [
"sumEarnings",
"day",
"sumEstimatedRewards",
"sumEstimatedPenalties",
"sumPriorityFees",
"sumBaselineMev",
"sumMissedExecutionRewards",
"sumConsensusBlockRewards",
"sumMissedConsensusBlockRewards",
"sumAttestationRewards",
"sumAllRewards",
"sumMissedAttestationRewards",
"sumMissedAttestationPenalties",
"sumWrongTargetPenalties",
"sumLateTargetPenalties",
"sumWrongHeadPenalties",
"sumLateSourcePenalties"
]
}
headers = {
"Content-Type": "application/json",
"X-Rated-Network": "mainnet",
"Authorization": "Bearer <YOUR-TOKEN-HERE>"
}
response = requests.get(url, params=params, headers=headers)
print(response.json())
{
"page": {
"from": "2023-08-31",
"to": null,
"size": 31,
"granularity": "day",
"filterType": "datetime"
},
"total": 405,
"data": [
{
"day": 1003,
"sumCorrectHead": 663,
"sumCorrectTarget": 673,
"avgCorrectness": 0.9930864197530864,
"avgInclusionDelay": 1.0177777777777777,
"sumInclusionDelay": 687.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 675,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 2,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 7
},
{
"day": 1002,
"sumCorrectHead": 668,
"sumCorrectTarget": 674,
"avgCorrectness": 0.9970304232804232,
"avgInclusionDelay": 1.0089020771513353,
"sumInclusionDelay": 680.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 674,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 0,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 1,
"sumWrongHeadVotes": 1
},
{
"day": 1001,
"sumCorrectHead": 660,
"sumCorrectTarget": 671,
"avgCorrectness": 0.9906172839506174,
"avgInclusionDelay": 1.0192592592592593,
"sumInclusionDelay": 688.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 675,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 4,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 7
},
{
"day": 1000,
"sumCorrectHead": 660,
"sumCorrectTarget": 673,
"avgCorrectness": 0.9891358024691358,
"avgInclusionDelay": 1.068148148148148,
"sumInclusionDelay": 721.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 670,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 5,
"sumWrongTargetVotes": 2,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 3
},
{
"day": 999,
"sumCorrectHead": 669,
"sumCorrectTarget": 674,
"avgCorrectness": 0.997530864197531,
"avgInclusionDelay": 1.002967359050445,
"sumInclusionDelay": 676.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 674,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 0,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 1,
"sumWrongHeadVotes": 3
},
{
"day": 998,
"sumCorrectHead": 667,
"sumCorrectTarget": 675,
"avgCorrectness": 0.9955555555555556,
"avgInclusionDelay": 1.031111111111111,
"sumInclusionDelay": 696.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 674,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 1,
"sumWrongTargetVotes": 0,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 6
},
{
"day": 997,
"sumCorrectHead": 662,
"sumCorrectTarget": 674,
"avgCorrectness": 0.9935736331569665,
"avgInclusionDelay": 1.0341246290801187,
"sumInclusionDelay": 697.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 673,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 1,
"sumWrongTargetVotes": 0,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 1,
"sumWrongHeadVotes": 1
},
{
"day": 996,
"sumCorrectHead": 669,
"sumCorrectTarget": 675,
"avgCorrectness": 0.9965432098765432,
"avgInclusionDelay": 1.0251851851851852,
"sumInclusionDelay": 692.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 674,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 1,
"sumWrongTargetVotes": 0,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 0
},
{
"day": 995,
"sumCorrectHead": 671,
"sumCorrectTarget": 674,
"avgCorrectness": 0.9975308641975308,
"avgInclusionDelay": 1.005925925925926,
"sumInclusionDelay": 679.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 675,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 1,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 2
},
{
"day": 994,
"sumCorrectHead": 658,
"sumCorrectTarget": 672,
"avgCorrectness": 0.9901168430335097,
"avgInclusionDelay": 1.0578635014836795,
"sumInclusionDelay": 713.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 672,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 2,
"sumWrongTargetVotes": 2,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 1,
"sumWrongHeadVotes": 4
},
{
"day": 993,
"sumCorrectHead": 668,
"sumCorrectTarget": 674,
"avgCorrectness": 0.9960493827160493,
"avgInclusionDelay": 1.0074074074074073,
"sumInclusionDelay": 680.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 675,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 1,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 3
},
{
"day": 992,
"sumCorrectHead": 663,
"sumCorrectTarget": 675,
"avgCorrectness": 0.9935802469135803,
"avgInclusionDelay": 1.0340740740740741,
"sumInclusionDelay": 698.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 674,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 1,
"sumWrongTargetVotes": 0,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 3
},
{
"day": 991,
"sumCorrectHead": 662,
"sumCorrectTarget": 675,
"avgCorrectness": 0.9935802469135803,
"avgInclusionDelay": 1.0103703703703704,
"sumInclusionDelay": 682.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 675,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 0,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 8
},
{
"day": 990,
"sumCorrectHead": 667,
"sumCorrectTarget": 675,
"avgCorrectness": 0.9960493827160493,
"avgInclusionDelay": 1.0177777777777777,
"sumInclusionDelay": 687.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 675,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 0,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 1
},
{
"day": 989,
"sumCorrectHead": 661,
"sumCorrectTarget": 673,
"avgCorrectness": 0.9935559964726632,
"avgInclusionDelay": 1.0430906389301635,
"sumInclusionDelay": 702.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 672,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 1,
"sumWrongTargetVotes": 0,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 2,
"sumWrongHeadVotes": 1
},
{
"day": 988,
"sumCorrectHead": 668,
"sumCorrectTarget": 673,
"avgCorrectness": 0.9955555555555556,
"avgInclusionDelay": 1.0074074074074073,
"sumInclusionDelay": 680.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 675,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 2,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 3
},
{
"day": 987,
"sumCorrectHead": 666,
"sumCorrectTarget": 673,
"avgCorrectness": 0.9945679012345678,
"avgInclusionDelay": 1.0177777777777777,
"sumInclusionDelay": 687.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 675,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 2,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 4
},
{
"day": 986,
"sumCorrectHead": 660,
"sumCorrectTarget": 667,
"avgCorrectness": 0.9955396987201269,
"avgInclusionDelay": 1.0104790419161678,
"sumInclusionDelay": 675.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 668,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 1,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 7,
"sumWrongHeadVotes": 3
},
{
"day": 985,
"sumCorrectHead": 665,
"sumCorrectTarget": 673,
"avgCorrectness": 0.994074074074074,
"avgInclusionDelay": 1.0133333333333334,
"sumInclusionDelay": 684.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 675,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 2,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 5
},
{
"day": 984,
"sumCorrectHead": 664,
"sumCorrectTarget": 673,
"avgCorrectness": 0.9930864197530864,
"avgInclusionDelay": 1.0222222222222221,
"sumInclusionDelay": 690.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 674,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 1,
"sumWrongTargetVotes": 2,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 4
},
{
"day": 983,
"sumCorrectHead": 670,
"sumCorrectTarget": 675,
"avgCorrectness": 0.9975308641975308,
"avgInclusionDelay": 1.0192592592592593,
"sumInclusionDelay": 688.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 675,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 0,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 1
},
{
"day": 982,
"sumCorrectHead": 668,
"sumCorrectTarget": 675,
"avgCorrectness": 0.9965432098765432,
"avgInclusionDelay": 1.0118518518518518,
"sumInclusionDelay": 683.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 675,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 0,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 2
},
{
"day": 981,
"sumCorrectHead": 669,
"sumCorrectTarget": 674,
"avgCorrectness": 0.9960493827160494,
"avgInclusionDelay": 1.0251851851851852,
"sumInclusionDelay": 692.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 674,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 1,
"sumWrongTargetVotes": 1,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 3
},
{
"day": 980,
"sumCorrectHead": 668,
"sumCorrectTarget": 673,
"avgCorrectness": 0.9955555555555554,
"avgInclusionDelay": 1.0044444444444445,
"sumInclusionDelay": 678.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 675,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 2,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 4
},
{
"day": 979,
"sumCorrectHead": 662,
"sumCorrectTarget": 668,
"avgCorrectness": 0.9959859553743345,
"avgInclusionDelay": 1.0254491017964071,
"sumInclusionDelay": 685.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 666,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 2,
"sumWrongTargetVotes": 0,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 7,
"sumWrongHeadVotes": 1
},
{
"day": 978,
"sumCorrectHead": 659,
"sumCorrectTarget": 673,
"avgCorrectness": 0.9906172839506172,
"avgInclusionDelay": 1.0296296296296297,
"sumInclusionDelay": 695.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 674,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 1,
"sumWrongTargetVotes": 2,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 6
},
{
"day": 977,
"sumCorrectHead": 667,
"sumCorrectTarget": 675,
"avgCorrectness": 0.9960493827160493,
"avgInclusionDelay": 1.0103703703703704,
"sumInclusionDelay": 682.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 675,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 0,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 3
},
{
"day": 976,
"sumCorrectHead": 670,
"sumCorrectTarget": 675,
"avgCorrectness": 0.9975308641975308,
"avgInclusionDelay": 1.008888888888889,
"sumInclusionDelay": 681.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 675,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 0,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 2
},
{
"day": 975,
"sumCorrectHead": 662,
"sumCorrectTarget": 671,
"avgCorrectness": 0.9925727513227512,
"avgInclusionDelay": 1.0222551928783383,
"sumInclusionDelay": 689.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 674,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 3,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 1,
"sumWrongHeadVotes": 6
},
{
"day": 974,
"sumCorrectHead": 663,
"sumCorrectTarget": 673,
"avgCorrectness": 0.9925925925925926,
"avgInclusionDelay": 1.0207407407407407,
"sumInclusionDelay": 689.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 674,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 1,
"sumWrongTargetVotes": 2,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 0,
"sumWrongHeadVotes": 7
},
{
"day": 973,
"sumCorrectHead": 670,
"sumCorrectTarget": 673,
"avgCorrectness": 0.9985140895753751,
"avgInclusionDelay": 1.0074294205052006,
"sumInclusionDelay": 678.0,
"slashesCollected": 0,
"slashesReceived": 0,
"sumCorrectSource": 673,
"sumMissedSyncSignatures": null,
"sumLateSourceVotes": 0,
"sumWrongTargetVotes": 0,
"sumLateTargetVotes": 0,
"sumLateTargetPenalties": 0.0,
"sumMissedAttestations": 2,
"sumWrongHeadVotes": 0
}
],
"next": "/v0/eth/validators/effectiveness?from=2023-07-31&size=31&granularity=day&filterType=datetime&include=validatorCount&include=avgInclusionDelay&include=avgUptime&include=avgCorrectness&include=avgProposerEffectiveness&include=avgValidatorEffectiveness&include=avgAttesterEffectiveness&include=sumCorrectHead&include=sumCorrectTarget&include=sumCorrectSource&include=sumInclusionDelay&include=sumProposedCount&include=sumProposerDutiesCount&include=sumLateTargetPenalties&include=slashesCollected&include=slashesReceived&include=day&include=sumMissedSyncSignatures&include=sumLateSourceVotes&include=sumWrongTargetVotes&include=sumMissedAttestations&include=sumWrongHeadVotes&include=sumLateTargetVotes&include=sumMissedAttestations&include=sumWrongHeadVotes&include=sumExecutionProposedEmptyCount&indices=675893&indices=675894&indices=675895&groupBy=timeWindow"
}
Name of the Entity. For this example, you should either put Lido
,Kiln
orCoinbase
Note: the operator_id is case-sensitive and should follow the same typecase as they are on the
For validator groupings, you will need to call the endpoint. We'll show this similarly as above for all reward details for the month of August 2023 for a set of validator indices, aggregated daily.
Successful Response
Successful Response
const response = await fetch('/v0/eth/operators/{operator_id}/effectiveness', {
method: 'GET',
headers: {},
});
const data = await response.json();
{
"page": {
"from": 0,
"to": 0,
"size": 10,
"granularity": "hour",
"filterType": "hour"
},
"total": 0,
"data": [
{
"day": 796,
"startEpoch": 179324,
"endEpoch": 179100,
"id": "Stakefish",
"idType": "nodeOperator",
"validatorCount": 16075,
"avgInclusionDelay": 1.0138705386457403,
"avgUptime": 0.9999466390184881,
"avgCorrectness": 0.9929917401071404,
"avgProposerEffectiveness": 99.53271028037379,
"avgValidatorEffectiveness": 97.96642775943795,
"totalUniqueAttestations": 3616682,
"sumCorrectHead": 3547355,
"sumCorrectTarget": 3612248,
"sumInclusionDelay": 3666847,
"sumProposedCount": 213,
"sumProposerDutiesCount": 214,
"slashesCollected": 0,
"slashesReceived": 0,
"sumEarnings": 56766373292,
"sumEstimatedRewards": 56675239144,
"sumEstimatedPenalties": -82967688,
"networkPenetration": 0.03132911454080191,
"sumPriorityFees": 10662221791,
"sumBaselineMev": 5266131924,
"sumMissedExecutionRewards": 58181568,
"sumConsensusBlockRewards": 6554423259,
"sumMissedConsensusBlockRewards": 31228533,
"sumAllRewards": 72694727007,
"sumCorrectSource": 3614403,
"avgAttesterEffectiveness": 97.9580945527236,
"sumMissedSyncSignatures": 2837,
"sumSyncCommitteePenalties": -44317643,
"sumLateSourceVotes": 2279,
"sumWrongTargetVotes": 4434,
"sumLateTargetVotes": 0,
"sumWrongTargetPenalties": -28763358,
"sumLateTargetPenalties": 0,
"sumMissedAttestations": 193,
"sumMissedAttestationPenalties": -1926140,
"sumWrongHeadVotes": 48767,
"sumWrongHeadPenalties": 0,
"sumAttestationRewards": 50120815885,
"sumLateSourcePenalties": -7960547,
"sumExecutionProposedEmptyCount": 0,
"sumMissedAttestationRewards": 269961427,
"sumMissedSyncCommitteeRewards": 44317643,
"sumExternallySourcedExecutionRewards": 14862131536
}
],
"next": "text"
}
const response = await fetch('/v0/eth/validators/effectiveness', {
method: 'GET',
headers: {},
});
const data = await response.json();
{
"data": [
{
"attesterEffectiveness": 98.46868397067385,
"avgCorrectness": 0.9951851851851852,
"avgInclusionDelay": 1.0107407407407407,
"day": 803,
"earnings": 35804991,
"endDay": 792,
"endEpoch": 178200,
"estimatedPenalties": -22921,
"estimatedRewards": 35849013,
"executionProposedEmptyCount": 0,
"proposedCount": 0,
"proposerDutiesCount": 0,
"slashesCollected": 0,
"slashesReceived": 0,
"startDay": 803,
"startEpoch": 180899,
"sumAllRewards": 35804991,
"sumAttestationRewards": 35849013,
"sumBaselineMev": 0,
"sumConsensusBlockRewards": 0,
"sumCorrectHead": 2665,
"sumCorrectSource": 2699,
"sumCorrectTarget": 2697,
"sumExternallySourcedExecutionRewards": 0,
"sumInclusionDelay": 2729,
"sumLateSourcePenalties": -3486,
"sumLateSourceVotes": 1,
"sumLateTargetPenalties": 0,
"sumLateTargetVotes": 0,
"sumMissedAttestationPenalties": 0,
"sumMissedAttestationRewards": 137813,
"sumMissedAttestations": 0,
"sumMissedConsensusBlockRewards": 0,
"sumMissedExecutionRewards": 0,
"sumMissedSyncCommitteeRewards": 0,
"sumPriorityFees": 0,
"sumSyncCommitteePenalties": 0,
"sumWrongHeadPenalties": 0,
"sumWrongHeadVotes": 21,
"sumWrongTargetPenalties": -19435,
"sumWrongTargetVotes": 3,
"syncSignatureCount": 0,
"totalAttestationAssignments": 2700,
"totalAttestations": 2919,
"totalUniqueAttestations": 2700,
"uptime": 1,
"validatorEffectiveness": 98.46868397067385
}
],
"next": "/v0/eth/validators/effectiveness?indices=100&indices=101&groupBy=timeWindow&granularity=month&size=1&from=791&filterType=day",
"page": {
"filterType": "day",
"granularity": "month",
"size": 1
},
"total": 27
}