All pages
Powered by GitBook
1 of 1

Loading...

Get bidder

Get bidder by public key

Query params

Query param
Description

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

Sorting

None

Optional properties

Property
Type
Description

Response

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 /bidders/{public_key}?era_id={era_id}

account_info

AccountInfo

Account info provided by the bidder

average_performance

ValidatorPerformance

Moving average of validator performance based on the received rewards over the past 360 eras (approximately one month)

centralized_account_info

CentralizedAccountInfo

Account information available for known accounts provided by CSPR.cloud team

cspr_name

string

Bidder
Get auction metrics API

Primary CSPR.name of the account

curl -X 'GET' \
  'https://api.testnet.cspr.cloud/bidders/0106ca7c39cd272dbf21a86eeb3b36b7c26e2e9b94af64292419f7862936bca2ca?era_id=12100' \
  -H 'accept: application/json' \
  -H 'authorization: 55f79117-fc4d-4d60-9956-65423f39a06a'
{
  "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
  }
}