Skip to main content
GET
/
v1
/
polkadot
/
validators
/
{validator_address}
/
rewards
Get validator rewards metrics
curl --request GET \
  --url https://api.rated.network/v1/polkadot/validators/{validator_address}/rewards \
  --header 'Authorization: Bearer <token>'
{
  "next": "https://api.rated.network//v1/polkadot/validators/{validator_address}/rewards?limit=10&offset=30",
  "pages": 10,
  "previous": "https://api.rated.network//v1/polkadot/validators/{validator_address}/rewards?limit=10&offset=10",
  "results": [
    [
      {
        "day": "2025-01-01",
        "nominatorCount": 280,
        "ownStake": 950000.536,
        "stashAccountAddress": "16Z2WxeQqm2SqKKPh8J68SSdhoQMWHhXznAG1ZME4kfA8T2V",
        "totalDelegatorRewards": 5901.121337991552,
        "totalStake": 9500000.552,
        "totalValidatorRewards": 295.056066899577,
        "validatorName": "Validator One"
      }
    ]
  ]
}
Using this endpoint, you can query the historical daily rewards of a validator by their unique stashAccountAddress, which is the address that manages the staking operations of a validator. The rewards are denominated in DOT and are attributed to a specific day when rewards were claimed.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
validator_address
string
required

Query Parameters

​
limit
integer
default:10

The number of results returned per page

​
offset
integer
default:0

The number of results to skip before starting to return

​
fromDate
string<date> | null

Start date

Examples:

"2023-01-01"

​
toDate
string<date> | null

End date

Examples:

"2023-12-31"

Response

Successful Response

​
previous
string | null
required
​
next
string | null
required
​
pages
integer
required
Required range: x >= 0
​
results
PolkadotValidatorRewards · object[]
required