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

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

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"
    }
]

PreviousdelegatorHistory NextmaxBuilderFee

Last updated 17 days ago