Skip to main content
GET
/
v1
/
celestia
/
validators
/
{validator_address}
/
rewards
Get validator rewards metrics
curl --request GET \
  --url https://api.rated.network/v1/celestia/validators/{validator_address}/rewards \
  --header 'Authorization: Bearer <token>'
{
  "previous": "<string>",
  "next": "<string>",
  "pages": 1,
  "results": [
    {
      "day": "2023-12-25",
      "validator": "<string>",
      "validatorMoniker": "<string>",
      "fromBlockNumber": 123,
      "toBlockNumber": 123,
      "totalDelegationRewards": 123,
      "totalCommissionRewards": 123,
      "commissionRate": 123,
      "consensusAddress": "<string>",
      "consensusPubkey": "<string>",
      "accountAddress": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.rated.network/llms.txt

Use this file to discover all available pages before exploring further.

Using this endpoint, you can query the historical daily rewards of a validator by their unique validator address. totalDelegationRewards are the Celestia rewards, denominated in TIA, which delegators are entitled to receive from the validator they have staked to. This includes the rewards towards a validator if they have self-staked/self-bonded. The rewards from the commission a validator charges are given by the totalCommissionRewards.

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

Example:

"2023-01-01"

​
toDate
string<date> | null

End date

Example:

"2023-12-31"

Response

Successful Response

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