📡
beaconcha.in Knowledge Base
  • 👋Welcome
  • 🖥️v2 beaconcha.in explorer [BETA]
    • 🎉Introducing v2-beta
    • 🦸Summary view
    • 🟩Slot visualization
    • 🫂Validator groups
    • ⚒️Manage Validators
    • ⚒️Manage Validators [API]
    • 🤝Share your custom dashboard
    • 📈Metric: Validator Efficiency
    • ⏰Notifications v2
  • v1 beaconcha.in Explorer
    • Notifications
      • Understanding notifications
      • Notification configuration
    • Mobile App <> Node Monitoring
    • Optimal Inclusion Distance
  • Ethereum Staking
    • Glossary
    • The Genesis Event
    • Ethereum Validator Keys
    • Deposit Process
    • Rewards and Penalties
    • Attestation
Powered by GitBook
On this page

Was this helpful?

Edit on GitHub
  1. v2 beaconcha.in explorer [BETA]

Manage Validators [API]

Manage your validators via API

Last updated 1 month ago

Was this helpful?

To modify the validator dashboard via API, make sure to have an active . After creating a and the desired through the User Interface, you can add and assign validators to groups using our API.


  • For mainnet, please adjust the base URL to:

  • The Group ID can be found in the Group Manage on the Dashboard

  • The Dashboard ID is visible in the Dashboard URL

  • During our beta the API key will only be visible in the on

  • Pass the API key as a parameter api_key

    • https://v2-beta-mainnet.beaconcha.in/api/v2/validator-dashboards/{dashboard_id}/validators?api_key=KEY

Please adjust the base URL from the examples below based on the network. Holesky: v2-beta-holesky.beaconcha.in Mainnet: v2-beta-mainnet.beaconcha.in Gnosis: v2-beta-gnosis.beaconcha.in

🖥️
⚒️
Orca subscription
validator dashboard
validator groups
v2-beta-mainnet.beaconcha.in
modal
account settings
https://beaconcha.in/user/settings#api
delete

Delete all validators from a specified group in a specified validator dashboard.

Authorizations
Path parameters
dashboard_idintegerRequired

The ID of the dashboard.

group_idintegerRequired

The ID of the group.

Responses
204
Validators removed successfully.
400
Bad Request
application/json
delete
DELETE /api/v2/validator-dashboards/{dashboard_id}/groups/{group_id}/validators HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

No content

  • POST/validator-dashboards/{dashboard_id}/validators
  • DELETE/validator-dashboards/{dashboard_id}/groups/{group_id}/validators
  • POST/validator-dashboards/{dashboard_id}/validators/bulk-deletions
post

Add new validators to a specified dashboard or update the group of already-added validators. This endpoint will always add as many validators as possible, even if more validators are provided than allowed by the subscription plan. The response will contain a list of added validators.

Authorizations
Path parameters
dashboard_idintegerRequired

The ID of the dashboard.

Body
deposit_addressstringOptional
graffitistringOptional
group_idintegerOptional
validatorsobject[]Optional
withdrawal_credentialstringOptional
Responses
201
Returns a list of added validators.
application/json
400
Bad Request
application/json
post
POST /api/v2/validator-dashboards/{dashboard_id}/validators HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "deposit_address": "text",
  "graffiti": "text",
  "group_id": 1,
  "validators": [
    {}
  ],
  "withdrawal_credential": "text"
}
{
  "data": [
    {
      "group_id": 1,
      "index": 1
    }
  ]
}
post

Remove specific validators from a specified dashboard in bulk.

Authorizations
Path parameters
dashboard_idintegerRequired

The ID of the dashboard.

Body
validatorsobject[]Optional
Responses
204
Validators removed successfully.
400
Bad Request
application/json
post
POST /api/v2/validator-dashboards/{dashboard_id}/validators/bulk-deletions HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "validators": [
    {}
  ]
}

No content