Sign in

v1

latestOpenAPI 3.1.02026-07-24223580832.9 KB
Ethereum Staking Reporting

Get Stats for an 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

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

Path parameters

networkstring required

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

addressstring required

The validator address to retrieve stats data for.

Response

OK

updateTimeinteger

epoch second timestamp of the end time the stats is for

Example response

{
  "updateTime": 1775718200,
  "thirtyDays": {
    "yield": {
      "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"
      }
    },
    "rewards": {
      "address": "0xaf3cfa981e084985c88928ae2fc7802790195d5d4e297fb384230b6b8e4540b2654a50a17dfeccc73f550461bd794563",
      "denomination": "wei",
      "return": "17859798000000000",
      "startTime": 1716422400,
      "endTime": 1719100799,
      "startBalance": "32002448366000000000",
      "metadata": {
        "epoch": "285413-287302",
        "withdrawals": "18477398000000000",
        "deposits": "0",
        "syncCommitteeReward": "0",
        "blockReward": "0",
        "attestationReward": "17859798000000000",
        "mevBlockReward": "0",
        "blockFeeReward": "0",
        "index": "1333904"
      }
    }
  },
  "ninetyDays": {
    "yield": {
      "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"
      }
    },
    "rewards": {
      "address": "0xaf3cfa981e084985c88928ae2fc7802790195d5d4e297fb384230b6b8e4540b2654a50a17dfeccc73f550461bd794563",
      "denomination": "wei",
      "return": "17859798000000000",
      "startTime": 1716422400,
      "endTime": 1719100799,
      "startBalance": "32002448366000000000",
      "metadata": {
        "epoch": "285413-287302",
        "withdrawals": "18477398000000000",
        "deposits": "0",
        "syncCommitteeReward": "0",
        "blockReward": "0",
        "attestationReward": "17859798000000000",
        "mevBlockReward": "0",
        "blockFeeReward": "0",
        "index": "1333904"
      }
    }
  }
}