Skip to main content
POST
/
api
/
v2
/
ethereum
/
validators
/
apy-roi
APY & ROI
curl --request POST \
  --url https://beaconcha.in/api/v2/ethereum/validators/apy-roi \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "validator": {
    "validator_identifiers": [
      1
    ]
  },
  "range": {
    "evaluation_window": "24h"
  },
  "chain": "mainnet"
}
'
{
  "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
      }
    },
    "finality": "finalized"
  },
  "range": {
    "slot": {
      "start": 1,
      "end": 1
    },
    "epoch": {
      "start": 1,
      "end": 1
    },
    "timestamp": {
      "start": 1,
      "end": 1
    }
  }
}

Authorizations

​
Authorization
string
header
required

Authorization header with value: Bearer YOUR_TOKEN. Refer to the API Keys section to create your API key.

Body

application/json
​
validator
Indexes/Public Keys · object
required

Free selectors available to all users:

  • validator_identifiers: One or more validator indices or public keys to filter by.
  • dashboard_id: Your beaconcha.in dashboard ID (requires a free account).

Premium selectors for Scale & Enterprise plans (https://beaconcha.in/pricing):

  • withdrawal: The validator's withdrawal credential or the Ethereum wallet address used for withdrawals.
  • deposit_address: The Ethereum wallet address used for the validator's deposit.
​
range
Fixed Window · object
required

The time period over which to evaluate the APY and ROI. If not provided, defaults to the last 30 days.

​
chain
enum<string>
default:mainnet

The Ethereum chain to query.

Available options:
mainnet,
hoodi

Response

Successful response.

Response containing apy and roi information of the validators.

​
data
object
required

Validator performance metrics, expressed both as ROI (Return on Investment) and APY (Annual Percentage Yield).

  • ROI represents the actual return over the selected evaluation window, not annualized.
  • APY is the same return but annualized to show the equivalent yearly rate.

ROI helps understand raw performance during the evaluation range, while APY allows comparison against annualized benchmarks. Note that APY is an extrapolation and does not reflect future performance.

​
range
object
required

The range of data covered by the results, specified in slots, epochs, and Unix timestamps.