⚒️Manage Validators [API]

Manage your validators via API

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

---

• For mainnet, please adjust the base URL to: v2-beta-mainnet.beaconcha.in

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

• The Dashboard ID is visible in the Dashboard URL

• During our beta the API key will only be visible in the account settings on https://beaconcha.in/user/settings#api

• 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

Add new validators to a specified dashboard or update the group of already-added validators.

post

/api/v2/validator-dashboards/{dashboard_id}/validators

Path parameters

dashboard_idstringrequired

The ID of the dashboard.

Body

group_idnumber

validatorsstring[]

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://beaconcha.in/api/v2/validator-dashboards/{dashboard_id}/validators' \
  --header 'Content-Type: application/json' \
  --data '{"validators":[null]}'

201

400

409

201

{
  "data": [
    {
      "public_key": "text",
      "group_id": 1
    }
  ]
}

Created

Remove validators from a dashboard

delete

/api/v2/validator-dashboards/{dashboard_id}/validators

Path parameters

dashboard_idstringrequired

The ID of the dashboard.

Query parameters

validatorsstring

Provide a comma seperated list of validator indices or public keys that should get removed.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://beaconcha.in/api/v2/validator-dashboards/{dashboard_id}/validators'

204

400

204

No body

No Content. The request was successful.