Delegator reward

The DelegatorReward entity offers a normalized representation of the Casper Network Reward related to the delegator account.

Properties

The DelegatorReward entity contains the following properties:

Property	Type	Description
delegator_identifier	string(64)	A representation of the delegator identifier, which can be either: a hex-encoded public key, or a purse URef, depending on delegator_identifier_type_id. Primary identifier
delegator_identifier_type_id	uint8	Identifier representing the type of the delegator identifier: 0 for PublicKey, 1 for purse URef
public_key	string(64)	The public key of the delegator account represented as a hexadecimal string. Primary account identifier (deprecated: use delegator_identifier instead, this property will be removed in future versions)
validator_public_key	string(64)	Public key of the validator represented as a hexadecimal string. Unique validator identifier
era_id	uint32	Era identifier
amount	uint64	Amount of the reward received by the delegator.
timestamp	datetime	Timestamp indicating when the last block was proposed.

Example

{
  "amount": "44272516539",
  "delegator_identifier": "018afa98ca4be12d613617f7339a2d576950a2f9a92102ca4d6508ee31b54d2c02",
  "delegator_identifier_type_id": 0,
  "era_id": 17997,
  "public_key": "018afa98ca4be12d613617f7339a2d576950a2f9a92102ca4d6508ee31b54d2c02",
  "timestamp": "2025-05-22T07:03:50Z",
  "validator_public_key": "01fe8594026624b992c840281cb528515bd8574d281c38222deaa6eb22546c7656"
}

Optional properties

Depending on the endpoint, the following optional properties may be included in the DelegatorReward entity:

Property	Type	Description
rate	float32	The rate that was relevant at the moment when the last block was proposed. To get more details see Including CSPR rates .
account_info	AccountInfo	Account info provided by the account owner
validator_account_info	AccountInfo	Account info provided by the validator
centralized_account_info	CentralizedAccountInfo	Account information available for known accounts provided by CSPR.cloud team
cspr_name	string	Primary CSPR.name of the account
validator_cspr_name	string	Primary CSPR.name of the validator account

Relations

The DelegatorReward entity has the following relations with other entities:

Entity	Mapping property	Description
Account	delegator_identifier, delegator_identifier_type_id	Accounts receive rewards for delegating to validators.
Purse	delegator_identifier, delegator_identifier_type_id	Purses receive rewards for delegating to validators.
Validator	validator_public_key	Delegation rewards are associated with the validator, that distributed the rewards

Endpoints

The DelegatorReward entity has the following endpoints:

• Get account delegation rewards

• Get total account delegation rewards

• Get purse delegation rewards

• Get total purse delegation rewards

• Get total validator delegators' rewards