Sign in

v1

latestOpenAPI 3.1.02026-07-24223580832.9 KB
Ethereum Staking Reporting

Get a Stream of Rewards

Returns the total rewards for the queried period in a streaming fashion using ndjson. The total reward returned is derived from the sum of fields in the response metadata:

Total Reward = mevBlockReward + syncCommitteeReward + attestationReward + blockReward
post/v2/ethereum/{network}/validator/rewards

Path parameters

network'mainnet' | 'holesky' | 'hoodi' required

Network

The network to look up against.

Request body

startTimenumber

Epoch-based start time for reward queries.

endTimenumber

Epoch-based end time for reward queries.

epochnumber

The eepoch to look up rewards for.

addressesstring[] required

List of addresses to retrieve rewards for.

period'yearly' | 'daily' | 'weekly' | 'monthly' | 'epoch' | 'raw'

How the data is aggregated.

aggregateboolean

Whether to aggregate across provided addresses or per address - true to aggregate across all addresses.

denomination'wei' | 'kwei' | 'mwei' | 'gwei' | 'szab' | 'finn' | 'eth' | 'ether' | 'kether' | 'keth' | 'mether' | 'meth' | 'gether' | 'geth' | 'tether' | 'teth'

Denomination

Example request

{
  "startTime": 1716422400,
  "endTime": 1717148216,
  "epoch": 365834,
  "addresses": [
    "0xaf3cfa981e084985c88928ae2fc7802790195d5d4e297fb384230b6b8e4540b2654a50a17dfeccc73f550461bd794563",
    "0x80000001677f23a227dfed6f61b132d114be83b8ad0aa5f3c5d1d77e6ee0bf5f73b0af750cc34e8f2dae73c21dc36f4a"
  ]
}

Response

OK