Get bidders Get a paginated list of bidders
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
Bidder active filter param
Comma-separated list of public key
Sorting
Sort bidders by delegators number
Sort bidders by total stake
Sort bidders by self stake
Sort bidders by network share
Default sorting is total_stake DESC
Optional properties
Moving average of validator performance based on the received rewards over the past 360 eras (approximately one month)
Account information available for known accounts provided by CSPR.cloud team
Primary CSPR.name of the account
Response
PaginatedResponse<Bidder>
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/bidders?era_id=12100' \
-H 'accept: application/json' \
-H 'authorization: 55f79117-fc4d-4d60-9956-65423f39a06a'
Copy {
"item_count" : 256 ,
"page_count" : 26 ,
"data" : [
{
"delegators_number" : 326 ,
"delegators_stake" : 515236483487045440 ,
"era_id" : 12136 ,
"fee" : 15 ,
"is_active" : true ,
"network_share" : "6.03" ,
"public_key" : "018f84c6fc037284f189cc8cb49f89212ff434a5eb050e48cdd164ff3890fbff69" ,
"rank" : 1 ,
"self_share" : "0.31" ,
"self_stake" : 1588933419545728 ,
"total_stake" : 516825416906591170
} ,
{
"delegators_number" : 1199 ,
"delegators_stake" : 327973756566146050 ,
"era_id" : 12136 ,
"fee" : 3 ,
"is_active" : true ,
"network_share" : "3.83" ,
"public_key" : "01c377281132044bd3278b039925eeb3efdb9d99dd5f46d9ec6a764add34581af7" ,
"rank" : 2 ,
"self_share" : "0.03" ,
"self_stake" : 85793744014762 ,
"total_stake" : 328059550310160830
} ,
...
{
"delegators_number" : 121 ,
"delegators_stake" : 206718215474570850 ,
"era_id" : 12136 ,
"fee" : 10 ,
"is_active" : true ,
"network_share" : "2.42" ,
"public_key" : "015fd964620f98e551065079e142840dac3fb25bd97a0d4722411cb439f9247d72" ,
"rank" : 10 ,
"self_share" : "0.2" ,
"self_stake" : 422749459877974 ,
"total_stake" : 207140964934448800
}
]
}