GET
/
v1
/
cardano
/
validators
/
{pool_id}
/
rewards
curl --request GET \
  --url https://api.rated.network/v1/cardano/validators/{pool_id}/rewards
{
  "next": "https://api.rated.network//v1/cardano/validators/{pool_id}/rewards?limit=10&offset=30",
  "pages": 10,
  "previous": "https://api.rated.network//v1/cardano/validators/{pool_id}/rewards?limit=10&offset=10",
  "results": [
    [
      {
        "day": "2025-01-01",
        "epoch": 531,
        "fromBlockNumber": 11292758,
        "fromSlotNumber": 144123334,
        "poolFee": 0.015,
        "poolFlatFee": 340,
        "poolHashId": "153806dbcd134ddee69a8c5204e38ac80448f62342f8c23cfe4b7edf",
        "poolId": "pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt",
        "poolName": "OctasPool",
        "poolOwnerStakeAddresses": [
          "stake1uy89kzrdlpaz5rzu8x95r4qnlpqhd3f8mf09edjp73vcs3qhktrtm"
        ],
        "poolTicker": "OCTAS",
        "toBlockNumber": 11297086,
        "toSlotNumber": 144209693,
        "totalEarnedDelegatorRewards": 3636438.165,
        "totalEarnedValidatorRewards": 3652841.165,
        "totalRealizedDelegatorRewards": 3636438.165,
        "totalRealizedValidatorRewards": 3652841.165
      }
    ]
  ]
}

Using this endpoint, you can query the historical daily rewards of a stake pool/validator by their unique poolId, which is a hash in the form of pool + 52 characters (ex: pool12vx0utf438rpxskmvwm870vpz6qnurdqekzjea39jzl7gs3hhhl) or poolHashId which is the hashed version of the poolId. These rewards are denominated in ADA.

totalRealizedDelegatorRewards and totalRealizedValidatorRewards refer to rewards already distributed to the members/delegators and stake pool owners/validators respectively based on the epoch when they were distributed. Meanwhile, totalEarnedDelegatorRewards and totalEarnedValidatorRewards refer to the rewards earned for an epoch but not yet distributed. These rewards are already net of the 20% cut that the treasury takes.

In terms of timing, we align these rewards according to the day when an epoch ended.

Path Parameters

​
pool_id
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 | null

Start date

​
toDate
string | null

End date

Response

200
application/json
Successful Response
​
previous
string | null
required
​
next
string | null
required
​
pages
integer
required
Required range: x > 0
​
results
object[]
required
SummaryNetwork rewards