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) × 365
grossApr = (delegation + commission rewards) / sum(weekly staked) × 365 — the implied fee for the week is 1 − 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

Field

Type

Description

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())

import axios from 'axios';

const response = await axios.post('https://api.hydromancer.xyz/info', {
    type: 'validatorAprHistory',
    validator: '0x5ac99df645f3414876c816caf18b2d234024b487'
}, {
    headers: {
        'Authorization': `Bearer ${process.env.HYDROMANCER_API_KEY}`,
        'Content-Type': 'application/json'
    }
});

console.log(response.data);

Response

Array of weekly entries, sorted by week descending.

Field

Type

Description

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

Response

[
    {
        "week": 1781481600000,
        "netApr": 0.0213,
        "grossApr": 0.0224,
        "totalDelegatorRewards": "2123.45000000"
    },
    {
        "week": 1780876800000,
        "netApr": 0.0224,
        "grossApr": 0.0224,
        "totalDelegatorRewards": "2231.10000000"
    }
]

PreviousstakingValidatorStakers NextstakingEvents

Last updated 9 days ago