ETH Rewards (for org, per validator)

post

https://rewards.datahub.figment.io/v3/rewards/ethereum/validator_addresses

The ETH Rewards endpoint returns rewards & balances for Figment validators, up to 7 days (for epoch) and 30 days (for daily rollup). This endpoint completes it by offering rewards & balances for any validator on the ETH network, with no historical limit.

To use it we’ll need to whitelist the validator public keys you want to retrieve, agnostic of any staking provider. Get in touch with us!

Body Params

chain_id

string | null

enum

Id of the chain that rewards belong to

Allowed:

time_rollup

string of strings

enum

required

Rollup to use when reporting the data. Allowed values are 'epoch', 'daily', and 'all_time'.

Allowed:

start

string

required

Lower bound of rewards data expressed as epoch number (for epoch rollup only) or timestamps (as strings "YYYY-MM-DD"). This parameter is ignored when all_time rollup is requested.

end

string

required

Upper bound of rewards data expressed as epoch number (for epoch rollup only) or timestamps (as strings "YYYY-MM-DD"). This parameter is ignored when all_time rollup is requested.

withdrawal_addresses

array of strings

A set of withdrawal addresses (or withdrawal credentials) to filter the results with.

withdrawal_addresses

validator_addresses

array of strings

A set of validator public keys to filter the results with.

validator_addresses

limit

integer

A number to limit the total number of records in the response. Only available to all_time time_rollup requests.

offset

integer

Pagination offset to start the results with. Only available to all_time time_rollup requests.

Response

200List of rewards and balances rolled up to the requested time_rollup. Results only includes validators that are registered with the current user's organization.