Skip to main content
GET
/
v0
/
polygon
/
delegators
/
{delegator_address}
/
summary
Delegator Summary
curl --request GET \
  --url https://api.rated.network/v0/polygon/delegators/{delegator_address}/summary \
  --header 'Authorization: Bearer <token>'
{
  "aggregateEffectiveness": 0.98865,
  "aprGross": 0.05,
  "aprNet": 0.05,
  "blendedCommissionRate": 0.05125,
  "delegations": [
    {
      "stakePercentage": 0.1,
      "validatorId": 103,
      "validatorName": "Stake Capital"
    },
    {
      "stakePercentage": 0.1,
      "validatorId": 104,
      "validatorName": "Coinbase Cloud"
    }
  ],
  "delegatorAddress": "0x00000",
  "networkPenetration": 0.1,
  "timeWindow": "30d",
  "totalCommissionPaid": 112722.21532,
  "totalDelegatorStake": 400995914.00753,
  "totalGrossRewards": 1859026.3456,
  "totalNetRewards": 1746304.13028
}
This endpoint returns high level information about a delegator over the time period such as their network penetration, rewards, annual percentage rate (APR), paid commissions, and the aggregate effectiveness of their validator delegates. Here’s how to interpret the inputs required to operate it
ParameterContext
windowWindow of the aggregation, with 1d, 7d, 30d and all being the supported values

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
delegator_address
string
required

Query Parameters

​
window
enum<string>
required
Available options:
1d,
7d,
30d,
all

Response

Successful Response

​
delegatorAddress
string
required
​
timeWindow
enum<string>
required
Available options:
1d,
7d,
30d,
all
​
networkPenetration
string
required
​
delegations
PolygonDelegation · object[]
required
​
aprGross
string | null
required
​
aprNet
string | null
required
​
aggregateEffectiveness
string
required
​
blendedCommissionRate
string
required
​
totalDelegatorStake
string
required
​
totalGrossRewards
string
required
​
totalNetRewards
string
required
​
totalCommissionPaid
string
required
⌘I