v1

latestOpenAPI 3.1.02026-07-24223580832.9 KB
Ethereum Staking Reporting

Get a Stream of Rewards for a Single Address

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
get/v2/ethereum/{network}/validator/rewards/{address}

Path parameters

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

Network

The network to look up against.

addressstring required

The address to look up rewards for.

Query parameters

startTimenumber

Epoch-based start time for reward queries.

endTimenumber

Epoch-based end time for reward queries.

epochnumber

The epoch to look up rewards for.

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

How the data is aggregated.

The type of aggregation to apply.

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

Denomination

Denomination to use for the response - default is wei.

Response

OK