Skip to main content
POST
/
api
/
v2
/
ethereum
/
validators
/
rewards-aggregate
Rewards Aggregated
curl --request POST \
  --url https://beaconcha.in/api/v2/ethereum/validators/rewards-aggregate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "validator": {
    "validator_identifiers": [
      1
    ]
  },
  "range": {},
  "chain": "mainnet"
}
'
{
  "data": {
    "total": "<string>",
    "total_reward": "<string>",
    "total_penalty": "<string>",
    "attestation": {
      "head": {
        "total": "<string>",
        "reward": "<string>",
        "penalty": "<string>",
        "missed_reward": "<string>"
      },
      "source": {
        "total": "<string>",
        "reward": "<string>",
        "penalty": "<string>",
        "missed_reward": "<string>"
      },
      "target": {
        "total": "<string>",
        "reward": "<string>",
        "penalty": "<string>",
        "missed_reward": "<string>"
      },
      "inactivity_leak_penalty": "<string>",
      "total": "<string>",
      "inclusion_delay": {
        "total": "<string>",
        "missed_reward": "<string>"
      }
    },
    "sync_committee": {
      "total": "<string>",
      "reward": "<string>",
      "penalty": "<string>",
      "missed_reward": "<string>"
    },
    "proposal": {
      "total": "<string>",
      "execution_layer_reward": "<string>",
      "attestation_inclusion_reward": "<string>",
      "sync_inclusion_reward": "<string>",
      "slashing_inclusion_reward": "<string>",
      "missed_cl_reward": "<string>",
      "missed_el_reward": "<string>"
    },
    "total_missed": "<string>"
  },
  "range": {
    "slot": {
      "start": 1,
      "end": 1
    },
    "epoch": {
      "start": 1,
      "end": 1
    },
    "timestamp": {
      "start": 1,
      "end": 1
    }
  }
}

Authorizations

​
Authorization
string
header
required

Authorization header with value: Bearer YOUR_TOKEN. Refer to the API Keys section to create your API key.

Body

application/json
​
validator
Indices/Pubkeys · object
required

Free selectors available to all users:

  • validator_identifiers: One or more validator indices or public keys to filter by.
  • dashboard_id: Your beaconcha.in dashboard ID (requires a free account).

Premium selectors for Scale & Enterprise plans (https://beaconcha.in/pricing):

  • withdrawal: The validator's withdrawal credential or the Ethereum wallet address used for withdrawals.
  • deposit_address: The Ethereum wallet address used for the validator's deposit.
  • entity: The name of the assigned entity (e.g., "Lido", "Coinbase"). Optionally include sub_entity for more specific filtering. Matching is case-insensitive.

Note: The set of validators matched by deposit_address and withdrawal selectors is updated once per epoch (~6.4 minutes). Newly deposited validators may take up to one epoch to appear in query results.

Note: The set of validators matched by entity selector is updated once per day.

​
range
Fixed Window · object
required

Specify a date range to receive aggregated data for that period — ideal for use cases like daily income tracking for income reporting.

Support for querying arbitrary time ranges using Unix timestamps, epochs, or slots will be coming soon, exclusively for Scale and Enterprise plans (https://beaconcha.in/pricing).

​
chain
enum<string>
default:mainnet

The Ethereum chain to query.

Available options:
mainnet,
hoodi

Response

Successful response.

Response containing aggregated rewards information of the validators.

​
data
object
required
​
range
object
required

The range of data covered by the results, specified in slots, epochs, and Unix timestamps.