Dashboard as Private Sets

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 single dashboard_id.

Validator Selector: The dashboard_id and group_id selectors work with validator endpoints including rewards-aggregate, rewards-list, and 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:

https://beaconcha.in/dashboard/123
                              ^^^
                          Dashboard ID

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

The default group (containing validators not assigned to any specific group) has Group ID 0.

Querying Rewards by Dashboard

Query rewards for all validators in your dashboard:

curl --request POST \
  --url https://beaconcha.in/api/v2/ethereum/validators/rewards-aggregate \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chain": "mainnet",
  "validator": {
    "dashboard_id": 123
  },
  "range": {
    "evaluation_window": "30d"
  }
}
'

Querying Rewards by Group

Query rewards for a specific group within your dashboard by adding group_id to your request:

curl --request POST \
  --url https://beaconcha.in/api/v2/ethereum/validators/rewards-aggregate \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chain": "mainnet",
  "validator": {
    "dashboard_id": 123,
    "group_id": 456
  },
  "range": {
    "evaluation_window": "all_time"
  }
}
'

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

*Prices for annual billing, excluding VAT

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*

Upgrade at beaconcha.in/premium to increase your dashboard capacity. Contact support for even higher limits.

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.

Introduction — Overview and endpoint comparison
Validator Dashboard Introduction — Full dashboard documentation
Validator Groups — Creating and managing groups
Dashboard Management APIs — API reference

Introduction

V2 API Docs

V1 API Docs

Overview

Why Use Dashboard Selectors?

Organized Groups

Scales with Add-ons

No Index Tracking

Real-Time Monitoring

Setting Up Your Dashboard

Step 1: Create a Dashboard

Step 2: Add Validators

Step 3: Create Groups (Optional)

Finding Your IDs

Dashboard ID

Group ID

Querying Rewards by Dashboard

Querying Rewards by Group

Managing Your Dashboard via API

Dashboard Tiers

Premium Add-Ons

Best Practices

Query by Dashboard or Group

Organize by Infrastructure

Use Meaningful Names

Regular Audits

​Overview

​Why Use Dashboard Selectors?

Organized Groups

Scales with Add-ons

No Index Tracking

Real-Time Monitoring

​Setting Up Your Dashboard

​Step 1: Create a Dashboard

​Step 2: Add Validators

​Step 3: Create Groups (Optional)

​Finding Your IDs

​Dashboard ID

​Group ID

​Querying Rewards by Dashboard

​Querying Rewards by Group

​Managing Your Dashboard via API

​Dashboard Tiers

​Premium Add-Ons

​Best Practices

Query by Dashboard or Group

Organize by Infrastructure

Use Meaningful Names

Regular Audits

​Related Resources

Overview

Why Use Dashboard Selectors?

Setting Up Your Dashboard

Step 1: Create a Dashboard

Step 2: Add Validators

Step 3: Create Groups (Optional)

Finding Your IDs

Dashboard ID

Group ID

Querying Rewards by Dashboard

Querying Rewards by Group

Managing Your Dashboard via API

Dashboard Tiers

Premium Add-Ons

Best Practices

Related Resources