Validators

Provides the list of validators and performance metrics for the account or the specified wallet.

Get rewards and aggregated node statistics for validators hosted by Chorus/Opus

POSThttp://localhost:8080/api/v1/validators

Body

from*one of

A query range start parameter. Can be one of: date string in format "YYYY-MM-DD", integer validator on-chain index, float effectiveness rating, string that represents integer value of the balance in gwei, or validator public key (accepts both 0x prefixed hex strings, and non-prefixed hex). If passed, must be of the same type as "to" parameter.

to*one of

tie_break_pubkeystring

When returning data on the validators response on the continue_query, some data might have the same value when ordering, for example, if we get validators using ValidatorBalance, the balance might be the same for multiple validators, to know where we continue the query from we use the public key as a tie-breaker.

statusarray of ValidatorStatus (enum)

sort_byenum

Sorting column to use (default is index)

indexeffectivenessbalancestatuspublic_key

sort_orderenum

Sorting order (ascending or descending)

ascdesc

validatorsarray of string

Array of indices or public signing key, if empty returns all validators

aggregate_daysinteger

Number of daily statistics aggregated in a single entry. The aggregation works as follows:

for percentage values, shows avg()
for gwei or count values, shows sum() By default, shows single day aggregations.

walletsarray of string

network*enum

Network for which to perform statistics request

ethereum

Response

Reward and performance data have been returned, to this day

Body

any

Request

const response = await fetch('http://localhost:8080/api/v1/validators', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "network": "ethereum",
      "from": "2019-05-17",
      "to": "2019-05-17"
    }),
});
const data = await response.json();

PreviousUnstake NextSigned exit transactions

const response = await fetch('http://localhost:8080/api/v1/validators', { method: 'POST', headers: { "Content-Type": "application/json" }, body: JSON.stringify({ "network": "ethereum", "from": "2019-05-17", "to": "2019-05-17" }), }); const data = await response.json();