---
title: "Get Stats for an address"
method: GET
path: "/v2/ethereum/{network}/validator/stats/{address}"
tags: ["Ethereum Staking Reporting"]
---

# Get Stats for an address

`GET /v2/ethereum/{network}/validator/stats/{address}`

Returns stats for an address including 30 and 90 days of yield and rewards data based  on utc days  If an address is not currently monitored a 404 is returned, on the first query for an address data is async calculated and then updated daily

## Path parameters

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

## Response `200`

OK

- StatsResponseEthereum
  - `updateTime` integer — epoch second timestamp of the end time the stats is for
  - `thirtyDays` object
    - `yield` 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
    - `rewards` RewardsResponse1 — The reward response object
      - `address` string — The address the reward is for.
      - `denomination` string — The denomination the reward is in.
      - `return` string, number — The staking return of the address for the period.
      - `startTime` number — Epoch-based start time for reward queries.
      - `endTime` number — Epoch-based end time for reward queries.
      - `period` 'yearly' | 'daily' | 'weekly' | 'monthly' | 'epoch' | 'raw' — How the data is aggregated.
      - `startBalance` string, number — The balance or stake at the start of the period.
      - `metadata` RewardsMetadata
        - `epoch` string — The epoch number/s that the period covers.
        - `withdrawals` string, number — The withdrawals in the period.
        - `deposits` string, number — The deposits in the period.
        - `syncCommitteeReward` string, number — The sync committee rewards in the period.
        - `blockReward` string, number — The block rewards in the period.
        - `attestationReward` string, number — The attestation rewards in the period.
        - `mevBlockReward` string, number — The mev block rewards in the period.
        - `blockFeeReward` string, number — The block fee rewards in the period.
        - `index` string, number — The validator index.
  - `ninetyDays` object
    - `yield` 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
    - `rewards` RewardsResponse1 — The reward response object
      - `address` string — The address the reward is for.
      - `denomination` string — The denomination the reward is in.
      - `return` string, number — The staking return of the address for the period.
      - `startTime` number — Epoch-based start time for reward queries.
      - `endTime` number — Epoch-based end time for reward queries.
      - `period` 'yearly' | 'daily' | 'weekly' | 'monthly' | 'epoch' | 'raw' — How the data is aggregated.
      - `startBalance` string, number — The balance or stake at the start of the period.
      - `metadata` RewardsMetadata
        - `epoch` string — The epoch number/s that the period covers.
        - `withdrawals` string, number — The withdrawals in the period.
        - `deposits` string, number — The deposits in the period.
        - `syncCommitteeReward` string, number — The sync committee rewards in the period.
        - `blockReward` string, number — The block rewards in the period.
        - `attestationReward` string, number — The attestation rewards in the period.
        - `mevBlockReward` string, number — The mev block rewards in the period.
        - `blockFeeReward` string, number — The block fee rewards in the period.
        - `index` string, number — The validator index.

## 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)