> 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/builder-guides/staking-and-validator-dashboards.md).

# Staking and validator dashboards

Compare Hyperliquid validators, list their stakers, and show each user's delegations and rewards.

Staking data comes in three levels: the validator set, one user's staking, and activity across the network. Each has its own requests.

Staking dashboards usually need to:

* list validators with their stake, commission and APR
* show a user's delegations, rewards and history
* follow staking activity across the network

**At a glance**

| What you need                          | Use                                                                                                                                                                                          |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Every validator, with network totals   | [stakingOverview](https://docs.hydromancer.xyz/readme/rest-api/staking/stakingoverview)                                                                                                      |
| A validator's weekly APR               | [validatorAprHistory](https://docs.hydromancer.xyz/readme/rest-api/staking/validatoraprhistory)                                                                                              |
| A validator's stakers                  | [stakingValidatorStakers](https://docs.hydromancer.xyz/readme/rest-api/staking/stakingvalidatorstakers)                                                                                      |
| A user's staked totals and delegations | [delegatorSummary](https://docs.hydromancer.xyz/readme/rest-api/delegations/delegatorsummary), [delegations](https://docs.hydromancer.xyz/readme/rest-api/delegations/delegations)           |
| A user's rewards and history           | [delegatorRewards](https://docs.hydromancer.xyz/readme/rest-api/delegations/delegatorrewards), [delegatorHistory](https://docs.hydromancer.xyz/readme/rest-api/delegations/delegatorhistory) |
| Staking events across the network      | [stakingEvents](https://docs.hydromancer.xyz/readme/rest-api/staking/stakingevents)                                                                                                          |
| Every staker's balances                | [globalStakingSummary](https://docs.hydromancer.xyz/readme/rest-api/staking/globalstakingsummary)                                                                                            |
| Current validator votes                | [validatorL1Votes](https://docs.hydromancer.xyz/readme/rest-api/delegations/validatorl1votes)                                                                                                |

**Listing validators**

[stakingOverview](https://docs.hydromancer.xyz/readme/rest-api/staking/stakingoverview) returns every validator, plus the network's `total_staked`, `validator_count` and `delegator_count`. Each validator has its `address`, `name`, `commission_bps`, `effective_stake`, `staker_count` and `is_jailed`. `commission_bps` is in basis points, so `300` is a 3% commission.

Add [validatorAprHistory](https://docs.hydromancer.xyz/readme/rest-api/staking/validatoraprhistory) for a validator's weekly APR. Pass the validator's address, and each week comes back with `netApr`, `grossApr` and `totalDelegatorRewards`:

* `netApr` is what delegators earn after commission, and `grossApr` is the rate before commission. Both are decimals, so `0.0217` is 2.17%.
* Weeks start on Monday, UTC, newest first. The request returns 12 weeks by default and up to 100.

[stakingValidatorStakers](https://docs.hydromancer.xyz/readme/rest-api/staking/stakingvalidatorstakers) returns the full staker list of one validator, each with its address and amount.

**Showing a user's staking**

* [delegatorSummary](https://docs.hydromancer.xyz/readme/rest-api/delegations/delegatorsummary) - totals: `delegated`, `undelegated`, `totalPendingWithdrawal` and `nPendingWithdrawals`
* [delegations](https://docs.hydromancer.xyz/readme/rest-api/delegations/delegations) - one row per validator: `amount` and `lockedUntilTimestamp`
* [delegatorRewards](https://docs.hydromancer.xyz/readme/rest-api/delegations/delegatorrewards) - one row per day and `source` (`delegation` or `commission`), with the HYPE amount and the `hypePrice` of that day. It returns 500 rows by default and up to 2,000
* [delegatorHistory](https://docs.hydromancer.xyz/readme/rest-api/delegations/delegatorhistory) - the user's staking actions: `delegate`, `cDeposit` and `withdrawal`. A withdrawal appears twice, with `phase` set to `initiated` and then `finalized`

The `hypePrice` on each reward row lets you show rewards in dollars at the time they were paid.

**Following network activity**

[stakingEvents](https://docs.hydromancer.xyz/readme/rest-api/staking/stakingevents) returns delegate, undelegate and withdrawal events with the user, validator, amount and time. Filter by `user`, `validator`, `eventType` or time. It returns 500 events by default and up to 2,000.

[globalStakingSummary](https://docs.hydromancer.xyz/readme/rest-api/staking/globalstakingsummary) returns three balances for every staker: delegated, pending unstake and available in staking. It is one MessagePack snapshot, sorted by staked balance and refreshed about every 10 minutes.

**Putting it together**

1. Load the validator table from `stakingOverview`.
2. Add an APR column from `validatorAprHistory`, one request per validator.
3. For a connected wallet, show `delegatorSummary`, `delegations` and `delegatorRewards`.
4. Refresh on a timer. Rewards are daily and APR is weekly, so a few minutes between refreshes is enough.
