Skip To Content

Blockdaemon Documentation

Important Updates

We are happy to announce important updates to our Staking Reporting API, released on October 30, 2022.

Following some customer feedback, we have changed the responses of some endpoints, making them easier for you to understand.

For ETH, our Staking Reporting API now includes MEV rewards and transaction fee rewards in all responses. This allows you to see a complete picture of all your earned rewards.

See the sections below to learn more:


Ethereum API Updates

Ethereum updates affect the following endpoints:

The following response fields have been changed:

  1. yield has been renamed to return
  2. timestamp has been removed
  3. timePeriod has been split out into timeStart and timeEnd, indicating more precisely the UTC timestamp of the beginning and end of the period
  4. timeUnit has been renamed to timeAggregation
  5. endingBalance has been deprecated in favor of startingBalance
  6. metadata has been added as a new object to contain protocol-specific data (e.g. MEV)
  7. Return value now includes txFeeRewardsand mevRewards
  8. protocolRewards, txFeeRewards and mevRewards will always be shown, even if the values are 0

Example

Here is an example of the response previously returned by Get Stake & Rewards of Validator:

https://svc.blockdaemon.com/reporting/staking/v1/ethereum/mainnet/validator/rewards/0xb6f83e120b08f4bd119d3cf0ddd1d329cfa01032fe3ea0743977828f28db2265051e59308b04f1e07908209e28aa2335
{
    "address": "0xb6f83e120b08f4bd119d3cf0ddd1d329cfa01032fe3ea0743977828f28db2265051e59308b04f1e07908209e28aa2335",
    "currency": "ETH",
    "yield": "0.023357528",
    "timePeriod": "2022-08-01 - 2022-08-07",
    "timeUnit": "weekly",
    "endingBalance": "33.519120322",
    "timestamp": "2022-08-01T00:00"
}

The following is now returned:

{
    "address": "0x88577732c45616e61bb1a5645dac0dbca90f975647daac16cb851ad4cbdaee7c42c426c7902a38f8b4c8f99a16f32200",
    "currency": "ETH",
    "return": 0.003142331,
    "timeStart": "2022-10-25T00:00:00Z",
    "timeEnd": "2022-10-25T23:59:59Z",
    "timeAggregation": "daily",
    "startingBalance": 34.119364869,
    "metadata": {
        "validatorIndex": 171473,
        "protocolRewards": 0.003142331,
        "txFeeRewards": 0,
        "mevRewards": 0
    }
}

Solana API Updates

Solana updates affect the following endpoints:

The following response fields have been changed:

  1. yield has been renamed to return
  2. timestamp has been removed
  3. timePeriod has been split out into timeStart and timeEnd, indicating more precisely the UTC timestamp of the beginning and end of the period
  4. timeUnit has been renamed to timeAggregation
  5. endingBalance has been deprecated in favor of startingBalance
  6. metadata has been added as a new object to contain protocol-specific data (e.g. the delegation address)
  7. delegationAddress has been moved to the metadata object because it is not present in all PoS
  8. epoch has been added to the metadata and will display the epoch number the rewards were earned in. Note that if the data is being aggregated (weekly or monthly) there will be several epochs so 0 is provided to indicate this without changing the format of the response.

Example

Here is an example of the response previously returned by Get Stake & Rewards of Validator:

https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/validator/rewards/7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy
{
    "address": "FQwewNXahV7MiZcLpY6p1xhUs2acVGQ3U5Xxc7FzV571",
    "delegationAddress": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
    "currency": "SOL",
    "yield": "41.596638472",
    "timePeriod": "360",
    "timeUnit": "epoch",
    "endingBalance": "815.722834358",
    "timestamp": "2022-10-15T21:02:52"
}

The following is now returned:

{
    "address": "FQwewNXahV7MiZcLpY6p1xhUs2acVGQ3U5Xxc7FzV571",
    "currency": "SOL",
    "return": "41.63547257",
    "timeStart": "2022-10-18T05:41:19Z",
    "timeEnd": "2022-10-18T05:41:19Z",
    "timeAggregation": "epoch",
    "startingBalance": "815.722834358",
    "metadata": {
        "delegationAddress": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
        "epoch": 361
    }
}

We don't support Internet Explorer

Please use Chrome, Safari, Firefox, or Edge to view this site.