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": {
    "evaluation_window": "24h"
  },
  "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>",
    "finality": "not_finalized"
  },
  "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
Indexes/Public Keys · 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.

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.

​
range
Fixed Window · object
required

Specify a time range using a pre-fixed evaluation window.

​
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.