Ethereum API v1 Overview

Learn all about Blockdaemon's Ethereum Staking Reporting API.

❗️

Now Supporting v2!

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

Overview

With Blockdaemon Ethereum Staking Reporting API, you can easily access Ethereum staking information, which can be used for financial data analysis.

  • The Ethereum Staking Reporting API endpoints allow the retrieval of staking data in the Ethereum Mainnet and Holesky testnet.
  • You can get the current or historical stake & rewards allocated to a given validator address and other data.

🚧

Please note

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


➡️ Get the 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 Get a 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
  }
}

➡️ Get a 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 Get the Status of a Validator endpoint is shown below.

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

➡️ Verify a 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 Verify a 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.