Bidder

The Bidder entity represents an account participating in the auction to become a Validator for the era after the next one. It has the same properties as the Validator entity, with the network share value being projected instead of actual.

The Bidder entity has the following properties:

Property	Type	Description
rank	uint8	Projected validator rank based on total bid amount
era_id	uint32	Auction era identifier
public_key	string(68)	Bidder account public key represented as a hexadecimal string
is_active	bool	Describes whether the bidder is active or not
fee	float32	Percentage of the rewards the bidder will retain for its services once becomes a validator
delegators_number	uint64	Number of delegators staked to the bidder
self_stake	uint64	Bidder 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 bidder stake. The sum of the self-stake and the delegator stakes.
self_share	float32	Percentage of the bidder's self-stake to its total stake
network_share	float32	Projected network stake share if the bidder becomes a validator

Example

{
  "delegators_number": 1200,
  "delegators_stake": 328805467747474750,
  "era_id": 12104,
  "fee": 3,
  "is_active": true,
  "network_share": "3.86",
  "public_key": "01c377281132044bd3278b039925eeb3efdb9d99dd5f46d9ec6a764add34581af7",
  "rank": 2,
  "self_share": "0.02",
  "self_stake": 78323555658770,
  "total_stake": 328883791303133500
}

Optional properties

Depending on the endpoint some of the following optional properties may be included in the Bidder entity:

Property	Type	Description
account_info	AccountInfo	Bidder account info provided by the account owner
centralized_account_info	CentralizedAccountInfo
average_performance	ValidatorPerformance	Moving average of validator performance based on the received rewards over the past 360 eras (approximately one month)

Relations

Entity	Mapping property	Description
Account	public_key	Auction bids are made by accounts
Validator performance	public_key	Bidders that were validators in the past have associated validator performance

Endpoints

The Bidder entity has the following endpoints:

• Get bidder
• Get bidders

Relation endpoints

None