Get validators Get a paginated list of validators
Query params
Active auction era identifier. Data for older eras aren't persistent for long, and will eventually become unavailable. This is a required parameter
Validator active filter param
Comma-separated list of public key
Sorting
Sort validators by delegators number
Sort validators by total stake
Sort validators by self stake
Sort validators by network share
Default sorting is total_stake DESC
Optional properties
Account information available for known accounts provided by CSPR.cloud team
Primary CSPR.name of the validator account
Validator average performance
Response
PaginatedResponse<Validator>
Example
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 .
Copy curl -X 'GET' \
'https://api.testnet.cspr.cloud/validators?era_id=12100' \
-H 'accept: application/json' \
-H 'authorization: 55f79117-fc4d-4d60-9956-65423f39a06a'
Copy {
"item_count" : 100 ,
"page_count" : 10 ,
"data" : [
{
"delegators_number" : 327 ,
"delegators_stake" : 514860723339425900 ,
"era_id" : 12099 ,
"fee" : 15 ,
"is_active" : true ,
"network_share" : "6.16" ,
"public_key" : "018f84c6fc037284f189cc8cb49f89212ff434a5eb050e48cdd164ff3890fbff69" ,
"rank" : 1 ,
"self_share" : "0.3" ,
"self_stake" : 1524223078827207 ,
"total_stake" : 516384946418253100
} ,
{
"delegators_number" : 537 ,
"delegators_stake" : 316963498155044600 ,
"era_id" : 12099 ,
"fee" : 10 ,
"is_active" : true ,
"network_share" : "3.78" ,
"public_key" : "01bf489970ee9ad639854b9a78ed19d08b5f8d8f2185099b44c0fc5f6f467b14b4" ,
"rank" : 2 ,
"self_share" : "0" ,
"self_stake" : 1756858998778 ,
"total_stake" : 316965255014043400
} ,
...
{
"delegators_number" : 122 ,
"delegators_stake" : 206573767985058270 ,
"era_id" : 12099 ,
"fee" : 10 ,
"is_active" : true ,
"network_share" : "2.47" ,
"public_key" : "015fd964620f98e551065079e142840dac3fb25bd97a0d4722411cb439f9247d72" ,
"rank" : 10 ,
"self_share" : "0.2" ,
"self_stake" : 405441796728029 ,
"total_stake" : 206979209781786300
}
]
}