Sign in

v1

latestOpenAPI 3.1.02026-07-24223580832.9 KB
Ethereum Staking Reporting

Get a Yield for a Validator Address

Returns yield data for the specified validator address. For more details on yield metrics and how they are calculated, see the Yield Metrics overview.

get/v2/ethereum/{network}/validator/yield/{address}

Path parameters

networkstring required

The blockchain network to query (e.g., mainnet).

addressstring required

The validator address to retrieve yield data for.

Query parameters

startTimenumber required

Epoch-based start time for reward queries.

endTimenumber required

Epoch-based end time for reward queries.

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

Denomination

The unit to return yield values in.

Response

OK

startTimenumber

Epoch-based start time for reward queries.

endTimenumber

Epoch-based end time for reward queries.

returnstring number

The staking return for all validators for the period

aprstring number

The APR for validators based on the return, total stake of the network and assuming 82125 epochs a year

aprPercentagestring number

The same as above but in percentage form

apystring number

The APY based on the above and assuming re-staking of all rewards after each epoch (Unlikely for ETH but kept in for completeness)

apyPercentagestring number

The same as above but in percentage form

denominationstring

the denomination the reward is in

stakestring number

the total stake across the full network

Example response

{
  "startTime": 1709251200,
  "endTime": 1711929600,
  "return": "283291849202",
  "apr": "0.0601",
  "aprPercentage": "6.01%",
  "apy": "0.06912",
  "apyPercentage": "6.912%",
  "denomination": "ETH",
  "stake": "3830810096309000",
  "metadata": {
    "epoch": "285413-287302",
    "protocolRewards": "11.582442116",
    "mevRewards": "2.55849541422880986",
    "blockRewards": "1.660716278059616145",
    "totalBalance": "33750555.15182654"
  }
}