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.