delegatorRewards

Query a user's daily HYPE staking rewards (delegation + commission).

Is a superset of Hyperliquid's delegatorRewards. Includes on top the hype mark price at time of reward distribution and total amount of hype staked.

Now also possible to be queried per validator so you can track exactly how each validator is performing.

Data availability: From 1 August 2025.

POST Request

Field	Type	Description
type	string	Must be "delegatorRewards"
user	string	Ethereum address (0x-prefixed, 42 characters)
validator	string	(Optional) Restrict to rewards from this validator only (0x-prefixed). Omit to sum across all validators.
startTime	number	(Optional) Earliest distribution time in ms (inclusive)
endTime	number	(Optional) Latest distribution time in ms (inclusive)
limit	number	(Optional) Max results to return. Default 500, max 2000.

cURL

curl -X POST https://api.hydromancer.xyz/info \
  -H "Authorization: Bearer $HYDROMANCER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "delegatorRewards",
    "user": "0x2a618f4f3f089c873af8cb674db2e43ae123d1cc"
  }'

Python

import requests
import os

response = requests.post(
    'https://api.hydromancer.xyz/info',
    json={
        'type': 'delegatorRewards',
        'user': '0x2a618f4f3f089c873af8cb674db2e43ae123d1cc'
    },
    headers={
        'Authorization': f'Bearer {os.environ.get("HYDROMANCER_API_KEY")}',
        'Content-Type': 'application/json'
    }
)

print(response.json())

Javascript

import axios from 'axios';

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

console.log(response.data);

---

Response

Array of reward entries, one per (day, source), sorted by time descending. totalAmount is HYPE, summed across all validators contributing to that day's distribution for the user — or, when the validator field is set, scoped to that single validator.

Field	Type	Description
time	number	Distribute-tick timestamp in milliseconds (first block at or after 00:00 UTC of the distribution day)
source	string	"delegation" or "commission"
totalAmount	string	HYPE reward, summed across all contributing validators
stakedAmount	string | null	HYPE staked to the contributing validators at the tick, summed. null for commission rows (not a stake position)
hypePrice	string | null	HYPE/USDC oracle price at the tick. null when no oracle price is available

Response

[
    {
        "time": 1745452800000,
        "source": "delegation",
        "totalAmount": "4.04380675",
        "stakedAmount": "12500.00",
        "hypePrice": "18.42"
    },
    {
        "time": 1745366400000,
        "source": "commission",
        "totalAmount": "0.91200000",
        "stakedAmount": null,
        "hypePrice": "18.39"
    }
]