Manage Validators [API]

Manage your validators via API

Last updated 8 days ago

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.

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

Path parameters

dashboard_id*string

The ID of the dashboard.

Body

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

Created

Body

dataarray of object

Request

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

{
  "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

No Content. The request was successful.

Request

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

Response

{
  "error": "text"
}