The Validator
entity provides a normalized representation of the Casper Network Validator. It includes the extended information about its stakes, fee, shares etc.
The Validator
entity has the following properties:
rank
uint8
Projected validator rank based on total stake amount
era_id
uint32
Current era validator identifier
public_key
string(68)
Validator public key represented as a hexadecimal string
is_active
bool
Describes whether the validator is active or not
fee
float32
Percentage of the rewards the validator retains for its services
delegators_number
uint64
Number of delegators staked to validator
self_stake
uint64
Validator self-stake calculated as a sum of the bidder stake and the stakes of the affiliated accounts provided via the Casper Account Info Standard
delegators_stake
uint64
Cumulative stake of all delegators
total_stake
uint64
Total validator stake. The sum of the self-stake and the delegator stakes
self_share
float32
Percentage of the validator's self-stake to its total stake
network_share
float32
Percentage of the validator's total stake to the total amount staked on the network
Example
Depending on the endpoint some of the following optional properties may be included in the Validator
entity:
centralized_account_info
Account information available for known accounts provided by CSPR.cloud team
The Validator
entity has the following endpoints:
The Validator
entity has the following relation endpoints:
Get validator by public key
era_id
Active auction era identifier. Data for older eras aren't persistent for long, and will eventually become unavailable. This is a required parameter
None
centralized_account_info
Account information available for known accounts provided by CSPR.cloud team
cspr_name
string
Primary CSPR.name of the validator account
Since this API works only with recent eras, you'll need to replace the era ID with the latest one, which you can fetch using the Get auction metrics API.
Get a paginated list of validators
era_id
Active auction era identifier. Data for older eras aren't persistent for long, and will eventually become unavailable. This is a required parameter
is_active
Validator active filter param
public_key
Comma-separated list of public key
rank
Sort validators by rank
fee
Sort validators by fee
delegators_number
Sort validators by delegators number
total_stake
Sort validators by total stake
self_stake
Sort validators by self stake
network_share
Sort validators by network share
Default sorting is total_stake DESC
centralized_account_info
Account information available for known accounts provided by CSPR.cloud team
cspr_name
string
Primary CSPR.name of the validator account
Since this API works only with recent eras, you'll need to replace the era ID with the latest one, which you can fetch using the Get auction metrics API.