⚒️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 Holesky, please adjust the base URL to: v2-beta-holesky.beaconcha.in

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

• 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-holesky.beaconcha.in/api/v2/validator-dashboards/{dashboard_id}/validators?api_key=KEY

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

POSThttps://beaconcha.in/api/v2/validator-dashboards/{dashboard_id}/validators

Path parameters

dashboard_id*string

The ID of the dashboard.

Body

application/json

validators: Provide a comma seperated list of validator indicies or public keys that should get added.

group_id: (optional) Provide a single group id, to which all validators get added to. If ommited, the default group will be used.

validatorsarray of string

group_idnumber

Response

201400409

Created

Body

application/json

dataarray of object

Request

JavaScriptCurlPython

const response = await fetch('https://beaconcha.in/api/v2/validator-dashboards/{dashboard_id}/validators', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

201400409

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

Remove validators from a dashboard

DELETEhttps://beaconcha.in/api/v2/validator-dashboards/{dashboard_id}/validators

Path parameters

dashboard_id*string

The ID of the dashboard.

Query parameters

Response

204400

No Content. The request was successful.

Request

JavaScriptCurlPython

const response = await fetch('https://beaconcha.in/api/v2/validator-dashboards/{dashboard_id}/validators', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

400

{
  "error": "text"
}