---
title: "Get a Yield for a Validator Address"
method: GET
path: "/v2/ethereum/{network}/validator/yield/{address}"
tags: ["Ethereum Staking Reporting"]
---

# Get a Yield for a Validator Address

`GET /v2/ethereum/{network}/validator/yield/{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](https://docs.blockdaemon.com/reference/stakingreporting-api-overview).

## Path parameters

- `network` string, required
- `address` string, required

## Query parameters

- `startTime` number, required
- `endTime` number, required
- `denomination` 'wei' | 'kwei' | 'mwei' | 'gwei' | 'szab' | 'finn' | 'eth' | 'ether' | 'kether' | 'keth' | 'mether' | 'meth' | 'gether' | 'geth' | 'tether' | 'teth' — Denomination

## Response `200`

OK

- YieldResponse — The yield response object
  - `startTime` number — Epoch-based start time for reward queries.
  - `endTime` number — Epoch-based end time for reward queries.
  - `return` string, number — The staking return for all validators for the period
  - `apr` string, number — The APR for validators based on the return, total stake of the network and assuming 82125 epochs a year
  - `aprPercentage` string, number — The same as above but in percentage form
  - `apy` string, 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)
  - `apyPercentage` string, number — The same as above but in percentage form
  - `denomination` string — the denomination the reward is in
  - `stake` string, number — the total stake across the full network
  - `metadata` union
    - YieldMetadata
      - `epoch` string — The epoch number/s that the period covers
      - `protocolRewards` string, number — The total protocol rewards in the period
      - `mevRewards` string, number — The total mev block rewards in the period
      - `blockRewards` string, number — The total block fee rewards in the period
      - `totalBalance` string, number — The total balance of the validators in the network (including pending withdrawals)
    - ValidatorYieldMetadata
      - `effectiveBalance` string, number — The effective balance of the validator at the start time
      - `mevBlockReward` string, number — The total mev block rewards in the period
      - `blockReward` string, number — The total block rewards in the period
      - `syncCommitteeReward` string, number — The sync comittee rewards for the period
      - `attestationReward` string, number — The attestation rewards for the period

## Other responses

- `400` — Bad Request
- `422` — Validation Error

---

[API](https://skmtc.dev/blockdaemon/apis/staking-api.md) · [All operations](https://skmtc.dev/blockdaemon/apis/staking-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/blockdaemon/staking-api/revisions/f94e296a08a3/schema)