> 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/staking/validatoraprhistory.md).

# validatorAprHistory

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

<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>"validatorAprHistory"</code></td></tr><tr><td><code>validator</code></td><td>string</td><td>Validator address (0x-prefixed, 42 characters)</td></tr><tr><td><code>startTime</code></td><td>number</td><td>(Optional) Earliest week time in ms (inclusive)</td></tr><tr><td><code>endTime</code></td><td>number</td><td>(Optional) Latest week time in ms (inclusive); must be ≥ <code>startTime</code></td></tr><tr><td><code>limit</code></td><td>number</td><td>(Optional) Max weeks to return. Default 12, max 100.</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": "validatorAprHistory",
    "validator": "0x5ac99df645f3414876c816caf18b2d234024b487"
  }'
```

{% endtab %}

{% tab title="Python" %}

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

{% endtab %}

{% tab title="Javascript" %}

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

{% endtab %}
{% endtabs %}

***

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

<details>

<summary>Response</summary>

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

</details>