Skip to main content
GET
/
v0
/
polygon
/
delegators
/
{delegator_address}
/
rewards
Delegator Rewards
curl --request GET \
  --url https://api.rated.network/v0/polygon/delegators/{delegator_address}/rewards \
  --header 'Authorization: Bearer <token>'
{
  "page": {
    "from": 123,
    "to": 123,
    "granularity": "checkpoint",
    "size": 1
  },
  "total": 1,
  "data": [
    {
      "delegatorAddress": "<string>",
      "validatorId": 1,
      "rewards": "<string>",
      "missedRewards": "<string>",
      "checkpoint": 1,
      "timestamp": "2023-12-25",
      "day": "2023-12-25",
      "fromCheckpoint": 1,
      "toCheckpoint": 1
    }
  ],
  "next": "<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.

This endpoint returns information about the rewards received by a delegator and the rewards it has missed out on over a number of checkpoints. The rewards can be broken down at a per checkpoint level or daily level as well. Here’s how to interpret the inputs required to operate it 👇
ParameterContext
fromStarting (highest) checkpoint (integer, e.g. 54000) or UTC date (e.g. from=“2023-11-22”)
toEnding (lowest) checkpoint (integer, e.g. 52922) or UTC date (e.g. from=“2023-10-31”)
granularityThe size of time increments you are looking to query. Can be checkpoint or day
sizeThe number of results included per page

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

​
from
any | null

The starting (highest) checkpoint or date (UTC) to return. For example, 41100 or 2021-01-01.

​
to
any | null

The ending (lowest) checkpoint or date (UTC) to return. For example, 41100 or 2021-01-01.

​
granularity
enum<string> | null

Checkpoint or UTC day

Available options:
checkpoint,
day
​
size
integer
default:15

Maximum number of time periods (days or checkpoint) in the results.

Response

Successful Response

​
page
Page · object
required
​
total
integer
required
Required range: x >= 0
​
data
PolygonDelegatorRewards · object[]
required
​
next
string | null