v1
latestOpenAPI 3.0.42026-07-2233241175.9 KBAPY & ROI
Returns the annual percentage yield (APY) and return on investment (ROI) for a known collection or group of validators. Known collections are referenced by index, public key, deposit address, or withdrawal address.
Use case guide: APY & ROI metrics explains how to choose a window, interpret return metrics, and decide when BeaconScore is the better comparison.
For comparing performance across different staking providers, we recommend using the BeaconScore from the Performance Aggregated endpoints instead of APY or ROI, as BeaconScore normalizes for luck and provides a fairer comparison. Note that some residual luck factors outside a validator's control can still influence BeaconScore, especially over short evaluation windows. See the Residual Luck Factors section in the BeaconScore documentation for details.
Coming Soon: Support for querying arbitrary time ranges using Unix timestamps, epochs, or slots — exclusively for Scale and Enterprise plans.
Request body
Response
Successful response.
Example response
{
"data": {
"execution_layer": {
"roi": {
"total": 0.15,
"missed": -0.02
},
"apy": {
"total": 2.76,
"missed": -0.5
}
},
"consensus_layer": {
"roi": {
"total": 0.15,
"missed": -0.02
},
"apy": {
"total": 2.76,
"missed": -0.5
}
},
"combined": {
"roi": {
"total": 0.15,
"missed": -0.02
},
"apy": {
"total": 2.76,
"missed": -0.5
}
}
}
}