Overview
Instead of manually tracking validator indices, you can use the Validator Dashboard to create private sets of validators. Once configured, query your entire dashboard or specific groups using a singledashboard_id.
Validator Selector: The
dashboard_id and group_id selectors work with all validator endpoints including /api/v2/ethereum/validators/rewards-aggregate, /api/v2/ethereum/validators/rewards-list, and /api/v2/ethereum/validators/performance-aggregate.Why Use Dashboard Selectors?
Organized Groups
Create custom validator groups to represent nodes, servers, or client configurations. Query rewards for each group separately using
group_id.Scales with Add-ons
With premium or Add-on subscriptions, your dashboard can scale up to 320,000+ ETH in stake.
No Index Tracking
Add validators once to your dashboard, then query by
dashboard_id without maintaining lists of indices.Real-Time Monitoring
The dashboard UI provides real-time slot visualization and performance metrics alongside API access.
Setting Up Your Dashboard
Step 1: Create a Dashboard
Visit beaconcha.in/dashboard and create a new dashboard.Step 2: Add Validators
You can add validators using multiple methods:| Method | Description | Best For |
|---|---|---|
| Validator indices | Enter indices like 1, 2, 3 | Small sets |
| Public keys | Enter full public keys | Specific validators |
| Deposit address | All validators from an address | Operators |
| Withdrawal credentials | All validators with same credentials | Staking pools |
| Graffiti matching | Validators with specific graffiti | Node operators |
Step 3: Create Groups (Optional)
Organize validators into groups to represent:- Different nodes or servers
- Different client configurations (Lighthouse, Prysm, Teku, etc.)
- Geographic locations
- Customer segments
Groups must currently be created through the Dashboard UI. Once created, you can manage validators within groups using the Dashboard Management APIs.
Finding Your IDs
Dashboard ID
Your Dashboard ID is visible in the URL:Group ID
To find your Group ID:- Go to your Validator Dashboard
- Click the Manage Groups button (grid icon) in the dashboard header
- In the modal that opens, you’ll see a list of all your groups
- The Group ID is displayed next to each group name
Querying Rewards by Dashboard
Query rewards for all validators in your dashboard:Querying Rewards by Group
Query rewards for a specific group within your dashboard by addinggroup_id to your request:
Example: Compare Rewards Across Node Groups
Compare performance across your node groups:Managing Your Dashboard via API
Once your dashboard and groups are set up, you can programmatically manage validators:| Action | Endpoint | Documentation |
|---|---|---|
| Add validators | POST /api/i/validator-dashboards/{id}/validators | API Reference |
| Remove from group | DELETE /api/i/validator-dashboards/{id}/groups/{gid}/validators | API Reference |
| Bulk delete | POST /api/i/validator-dashboards/{id}/validators/bulk-deletions | API Reference |
Dashboard management APIs require an Orca subscription.
Dashboard Tiers
Dashboard capacity is based on Max Stake (ETH), not validator count:| Tier | Max Stake | Dashboards | Price/mo | Best For |
|---|---|---|---|---|
| Free | — | 1 | Free | Individual stakers |
| Guppy | 3,200 ETH | 1 | €8.99* | Small operators |
| Dolphin | 9,600 ETH | 2 | €25.99* | Professional operators |
| Orca | 32,000 ETH | 2 | €39.99* | Large operators |
Premium Add-Ons
Need more capacity? Add-ons stack on top of your base tier:| Add-On | Extra Capacity | Price/mo |
|---|---|---|
| +32,000 ETH | +32,000 ETH per dashboard | €59.99* |
| +320,000 ETH | +320,000 ETH per dashboard | €359.99* |
Best Practices
Query by Dashboard or Group
Use
dashboard_id to query all validators, or add group_id to filter by a specific group.Organize by Infrastructure
Create groups by node, client, or geographic location to isolate performance metrics.
Use Meaningful Names
Name groups clearly so API results are easy to interpret and report on.
Regular Audits
Periodically verify your dashboard contains all expected validators.
Related Resources
- Introduction — Overview and endpoint comparison
- Validator Dashboard Introduction — Full dashboard documentation
- Validator Groups — Creating and managing groups
- Dashboard Management APIs — API reference

