Network

Querying into network aggregate stats

Endpoints in this category 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.

Network overview

Get Network Overview

GET/v0/polygon/network/overview

Response

200400

Successful Response

Body

application/json

timeWindow*TimeWindow

An enumeration.

1d7d30dall

networkEffectiveness*Networkeffectiveness

networkCheckpointSigningRate*Networkcheckpointsigningrate

networkCheckpointProposalRate*Networkcheckpointproposalrate

networkBorProposalRate*Networkborproposalrate

validatorApr*Validatorapr

netValidatorApr*Netvalidatorapr

delegatorApr*Delegatorapr

heimdallCheckpointApr*Heimdallcheckpointapr

borProposalApr*Borproposalapr

heimdallCheckpointRewardsRatio*Heimdallcheckpointrewardsratio

borProposalRewardsRatio*Borproposalrewardsratio

activeValidatorCount*Activevalidatorcount

activeValidatorDiff*Activevalidatordiff

activeDelegatorCount*Activedelegatorcount

activeDelegatorDiff*Activedelegatordiff

totalStake*Totalstake

totalDelegatedStake*Totaldelegatedstake

avgDelegatedStake*Avgdelegatedstake

totalSelfStake*Totalselfstake

rewardsCheckpointSignatures*Rewardscheckpointsignatures

rewardsCheckpointProposals*Rewardscheckpointproposals

rewardsBorPriorityFees*Rewardsborpriorityfees

rewardsBorMev*Rewardsbormev

avgValidatorDelegates*Avgvalidatordelegates

blendedCommissionRate*Blendedcommissionrate

networkEffectivenessDiff*Networkeffectivenessdiff

networkCheckpointSigningRateDiff*Networkcheckpointsigningratediff

networkCheckpointProposalRateDiff*Networkcheckpointproposalratediff

networkBorProposalRateDiff*Networkborproposalratediff

Request

JavaScriptCurlPython

const response = await fetch('/v0/polygon/network/overview', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

[
  {
    "timeWindow": "30d",
    "networkEffectiveness": 0.999,
    "networkCheckpointSigningRate": 0.999,
    "networkCheckpointProposalRate": 0.999,
    "networkBorProposalRate": 0.999,
    "validatorApr": 0.999,
    "netValidatorApr": 0.998,
    "delegatorApr": 0.999,
    "heimdallCheckpointApr": 0.99,
    "borProposalApr": 0.99,
    "heimdallCheckpointRewardsRatio": 0.99,
    "borProposalRewardsRatio": 0.99,
    "activeValidatorCount": 999,
    "activeValidatorDiff": -10,
    "activeDelegatorCount": 999,
    "activeDelegatorDiff": 999,
    "totalStake": 999,
    "totalDelegatedStake": 999,
    "avgDelegatedStake": 999,
    "totalSelfStake": 999,
    "rewardsCheckpointSignatures": 999,
    "rewardsCheckpointProposals": 999,
    "rewardsBorPriorityFees": 999,
    "rewardsBorMev": 999,
    "avgValidatorDelegates": 999,
    "blendedCommissionRate": 0.99,
    "network_effectiveness_diff": 0.01,
    "network_checkpoint_signing_rate_diff": 0.01,
    "network_checkpoint_proposal_rate_diff": 0.01,
    "network_bor_proposal_rate_diff": 0.01
  }
]

This endpoint returns a summary of key statistics for the whole network including effectiveness and its components, delegator and validator annual percentage rates (APR), staking metrics, and duty-specific rewards.