validatorAprHistory
Query a validator's weekly net staking APR and rewards distributed to delegators.
Returns a validator's weekly delegator APR — both net (what delegators earn, after the validator's commission) and gross (the validator's pre-commission rate) — one entry per week (Monday-start, UTC), newest first. Both are simple (non-compounded) annualized rates expressed as raw fractions (0.182 = 18.2%):
netApr=sum(weekly delegation rewards) / sum(weekly staked) × 365grossApr=(delegation + commission rewards) / sum(weekly staked) × 365— the implied fee for the week is1 − netApr/grossApr
totalDelegatorRewards is the net HYPE distributed to delegators that week.
Values are recomputed once per day, shortly after the midnight-UTC reward distribution; the most recent (in-progress) week is partial until it closes.
Data availability: From 1 August 2025.
POST Request
type
string
Must be "validatorAprHistory"
validator
string
Validator address (0x-prefixed, 42 characters)
startTime
number
(Optional) Earliest week time in ms (inclusive)
endTime
number
(Optional) Latest week time in ms (inclusive); must be ≥ startTime
limit
number
(Optional) Max weeks to return. Default 12, max 100.
curl -X POST https://api.hydromancer.xyz/info \
-H "Authorization: Bearer $HYDROMANCER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "validatorAprHistory",
"validator": "0x5ac99df645f3414876c816caf18b2d234024b487"
}'import requests
import os
response = requests.post(
'https://api.hydromancer.xyz/info',
json={
'type': 'validatorAprHistory',
'validator': '0x5ac99df645f3414876c816caf18b2d234024b487'
},
headers={
'Authorization': f'Bearer {os.environ.get("HYDROMANCER_API_KEY")}',
'Content-Type': 'application/json'
}
)
print(response.json())Response
Array of weekly entries, sorted by week descending.
week
number
Week-start timestamp in milliseconds (Monday 00:00 UTC)
netApr
number
Net-of-commission delegator APR, raw fraction (0.0213 = 2.13%); simple, non-compounded
grossApr
number
Pre-commission APR (the validator's raw rate), raw fraction; implied fee = 1 − netApr/grossApr
totalDelegatorRewards
string
Net HYPE distributed to this validator's delegators during the week
Last updated