Ethereum API v1 Overview

❗️

Now Supporting v2!

This section covers Ethereum Staking Reporting v1. For upgraded functionality, check out our Ethereum Staking Reporting v2.

Overview

The Ethereum Staking Reporting API provides easy access to staking data, including current or historical stakes, rewards, and other information for a validator address.

Supported networks are:

  • Mainnet
  • Holesky

🚧

Please note

You can query historical data since 11th April, 2022.


➡️ Stake & Rewards

Endpoints

Endpoint
Get a Validator's Stake & Rewards - GET /validator/rewards/{address}
Get a List of Stake & Rewards for Multiple Validators - POST /validator/rewards
Get a Validator's Historical Stake & Rewards - POST /validator/history/{address}
Get the Historical Stake & Rewards for Multiple Validators - POST /validator/history

Sample Object

The example object returned by the Validator's Stake & Rewards endpoint is shown below.

{
  "address": "0x86c743cb852d18db0a5d24b4ed804622ec62eae57acdd3d920e1e31d424aed45dec48e6885680d8ff8cf0cb643929119",
  "currency": "ETH",
  "return": 0.002805534,
  "timeStart": "2023-05-22T00:00:00Z",
  "timeEnd": "2023-05-22T23:59:59Z",
  "timeAggregation": "daily",
  "startingBalance": 36.568211131,
  "metadata": {
    "validatorIndex": 4301,
    "protocolRewards": 0.002805534,
    "txFeeRewards": 0,
    "mevRewards": 0
  }
}

➡️ Status

Endpoints

Endpoint
Get the Status of a Validator - GET /validator/status/{address}
Get a List of Statuses of Multiple Validators - POST /validator/status

Sample Object

The example object returned by the Status of a Validator endpoint is shown below.

{
  "address": "0x86c743cb852d18db0a5d24b4ed804622ec62eae57acdd3d920e1e31d424aed45dec48e6885680d8ff8cf0cb643929119",
  "status": "active_ongoing",
  "index": 4301,
  "earliestReportDate": "2020-12-01"
}

➡️ Staking Activity

Endpoints

Endpoint
Verify a Validator's Staking Activity - GET /validator/active/{address}
Verify a List of Staking Activity for Multiple Validators - POST /validator/active

Sample Object

The example object returned by the Validator's Staking Activity endpoint is shown below.

{
  "0x86c743cb852d18db0a5d24b4ed804622ec62eae57acdd3d920e1e31d424aed45dec48e6885680d8ff8cf0cb643929119": true
}

👋 Need Help?

Contact us through email or our support page for any issues, bugs, or assistance you may need.