> For the complete documentation index, see [llms.txt](https://docs.hydromancer.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hydromancer.xyz/readme/rest-api/delegations/delegatorrewards.md).

# delegatorRewards

Query a user's daily HYPE staking rewards on Hyperliquid (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

<table><thead><tr><th width="161.9998779296875">Field</th><th width="119">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>type</code></td><td>string</td><td>Must be <code>"delegatorRewards"</code></td></tr><tr><td><code>user</code></td><td>string</td><td>Ethereum address (0x-prefixed, 42 characters)</td></tr><tr><td><code>validator</code></td><td>string</td><td>(Optional) Restrict to rewards from this validator only (0x-prefixed). Omit to sum across all validators.</td></tr><tr><td><code>startTime</code></td><td>number</td><td>(Optional) Earliest distribution time in ms (inclusive)</td></tr><tr><td><code>endTime</code></td><td>number</td><td>(Optional) Latest distribution time in ms (inclusive)</td></tr><tr><td><code>limit</code></td><td>number</td><td>(Optional) Max results to return. Default 500, max 2000.</td></tr></tbody></table>

{% tabs %}
{% tab title="cURL" %}

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

{% endtab %}

{% tab title="Python" %}

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

{% endtab %}

{% tab title="Javascript" %}

```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);
```

{% endtab %}
{% endtabs %}

***

## 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                                        |

<details>

<summary>Response</summary>

```json
[
    {
        "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"
    }
]
```

</details>
