> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.
# delegatorRewards | Hyperliquid info
> The info endpoint with type: "delegatorRewards" retrieves comprehensive staking rewards history for a specific user on the Hyperliquid exchange.
You can only use this endpoint on the official Hyperliquid public API. It is not available through Chainstack, as the open-source node implementation does not support it yet. See [Hyperliquid methods](/docs/hyperliquid-methods) for the full availability breakdown.
The `info` endpoint with `type: "delegatorRewards"` retrieves comprehensive staking rewards history for a specific user on the Hyperliquid exchange. This endpoint provides detailed historical data about rewards earned from delegation and validator commission, including timestamps and reward amounts, enabling thorough analysis of staking reward performance and validator earnings.
## Parameters
### Request body
* `type` (string, required) — The request type. Must be `"delegatorRewards"` to retrieve staking rewards.
* `user` (string, required) — Address in 42-character hexadecimal format; e.g. 0x0000000000000000000000000000000000000000.
## Response
The response is an array of staking reward events, ordered chronologically. Each event represents rewards earned from either delegation or validator commission activities.
### Response structure
Each reward event contains:
**Event timing:**
* `time` — Timestamp of the reward event in milliseconds since Unix epoch
* Indicates when the rewards were distributed or earned
**Reward source:**
* `source` — Source of the reward, indicating the type of staking activity
* `"delegation"` — Rewards earned from delegating tokens to validators
* `"commission"` — Commission earned from operating as a validator
**Reward amount:**
* `totalAmount` — Total amount of rewards received as a string for precision
* Represents the quantity of tokens earned from the staking activity
### Reward source types
**Delegation rewards (`source: "delegation"`):**
* Rewards earned by delegating tokens to validators
* Proportional to the amount staked and validator performance
* Regular rewards distributed based on network parameters
* Represents passive staking income
**Commission rewards (`source: "commission"`):**
* Commission earned from operating as a validator
* Percentage of rewards from users who delegate to this validator
* Only applicable if the user operates a validator node
* Represents active validator income
### Data interpretation
**Reward frequency:**
* Events show when rewards are distributed
* Frequency depends on network reward distribution schedule
* Regular patterns indicate consistent staking participation
**Reward amounts:**
* Amounts vary based on staked quantity and network conditions
* Delegation rewards scale with delegation amount
* Commission rewards scale with total delegated stake to validator
**Performance tracking:**
* Historical rewards enable performance analysis
* Compare rewards across different time periods
* Assess the effectiveness of staking strategies
## Staking rewards analysis
### Reward performance metrics
**Total rewards calculation:**
* Sum all reward amounts to calculate total earnings
* Separate delegation rewards from commission rewards
* Track reward accumulation over time
**Reward rate analysis:**
* Calculate average rewards per time period
* Analyze reward rate trends and variations
* Compare performance across different validators
**Yield calculation:**
* Calculate annualized percentage yield (APY)
* Compare staking yields to other investment options
* Assess risk-adjusted returns from staking
### Validator performance assessment
**Delegation reward consistency:**
* Analyze consistency of delegation rewards over time
* Identify periods of high or low reward performance
* Correlate rewards with validator uptime and performance
**Commission earnings (for validators):**
* Track commission earnings from delegators
* Analyze growth in commission over time
* Assess validator business performance
### Reward optimization insights
**Staking strategy evaluation:**
* Compare rewards from different validators
* Identify optimal delegation strategies
* Analyze the impact of delegation timing on rewards
**Compound growth analysis:**
* Track how rewards contribute to overall staking position
* Analyze the effect of reward compounding
* Optimize reward reinvestment strategies
### Risk and return analysis
**Reward volatility:**
* Analyze variability in reward amounts over time
* Assess reward stability across different market conditions
* Identify factors affecting reward consistency
**Diversification benefits:**
* Compare rewards from multiple validators
* Analyze risk reduction through validator diversification
* Optimize validator selection for risk-adjusted returns
## Example request
```shell Shell theme={"system"}
curl -X POST \
-H "Content-Type: application/json" \
-d '{"type": "delegatorRewards", "user": "0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036"}' \
https://api.hyperliquid.xyz/info
```
```python Python (hyperliquid-python-sdk) theme={"system"}
from hyperliquid.info import Info
from hyperliquid.utils import constants
# delegatorRewards is public-only, so use the Hyperliquid mainnet API URL
info = Info(constants.MAINNET_API_URL, skip_ws=True)
rewards = info.user_staking_rewards("0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036")
print(rewards)
```
```typescript TypeScript (@nktkas/hyperliquid) theme={"system"}
import * as hl from "@nktkas/hyperliquid";
// delegatorRewards is public-only, so use the default public transport
const transport = new hl.HttpTransport();
const client = new hl.InfoClient({ transport });
const rewards = await client.delegatorRewards({
user: "0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036",
});
console.log(rewards);
```
## Example response
```json theme={"system"}
[
{
"time": 1736726400073,
"source": "delegation",
"totalAmount": "0.73117184"
},
{
"time": 1736726400073,
"source": "commission",
"totalAmount": "130.76445876"
},
{
"time": 1736640000073,
"source": "delegation",
"totalAmount": "0.69823456"
}
]
```
## Use cases
The `info` endpoint with `type: "delegatorRewards"` is essential for applications that need to:
* **Track staking rewards**: Monitor all delegation and commission rewards over time
* **Calculate total earnings**: Sum up rewards to determine total staking income
* **Analyze reward patterns**: Study reward frequency and amounts across time periods
* **Tax reporting**: Generate historical reward data for tax calculation purposes
* **Performance analysis**: Analyze staking yield and validator performance
* **Validator comparison**: Compare rewards earned from different validators
* **Portfolio management**: Manage staking portfolios and reward reinvestment strategies
* **Yield optimization**: Optimize staking strategies based on historical reward data
* **Commission tracking**: Monitor validator commission earnings (for validator operators)
* **Audit trails**: Provide complete records of all staking reward activities
This endpoint provides comprehensive staking reward history, enabling detailed analysis and optimization of delegation strategies on the Hyperliquid network.
## OpenAPI
````yaml openapi/hyperliquid_node_api/hypercore_info/info_delegator_rewards.json post /info
openapi: 3.0.0
info:
title: Hyperliquid Node API - Delegator Rewards
version: 1.0.0
servers:
- url: https://api.hyperliquid.xyz
security: []
paths:
/info:
post:
summary: Query a user's staking rewards
description: >-
Retrieve comprehensive staking rewards history for a specific user,
including delegation rewards and commission earnings with timestamps and
reward sources.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- type
- user
properties:
type:
type: string
enum:
- delegatorRewards
default: delegatorRewards
description: >-
The request type. Must be 'delegatorRewards' to retrieve
staking rewards.
user:
type: string
pattern: ^0x[a-fA-F0-9]{40}$
default: '0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036'
description: >-
Address in 42-character hexadecimal format; e.g.
0x0000000000000000000000000000000000000000.
example:
type: delegatorRewards
user: '0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036'
responses:
'200':
description: Successful response with staking rewards data
content:
application/json:
schema:
type: array
description: Array of staking reward events
items:
type: object
properties:
time:
type: integer
format: int64
description: Timestamp of the reward event in milliseconds
source:
type: string
enum:
- delegation
- commission
description: >-
Source of the reward: 'delegation' for staking rewards
or 'commission' for validator commission
totalAmount:
type: string
description: Total amount of rewards received
required:
- time
- source
- totalAmount
example:
- time: 1736726400073
source: delegation
totalAmount: '0.73117184'
- time: 1736726400073
source: commission
totalAmount: '130.76445876'
- time: 1736640000073
source: delegation
totalAmount: '0.68234567'
````