Validator income detail history

curl --request GET \
  --url 'https://beaconcha.in/api/v1/validator/{indexOrPubkey}/incomedetailhistory?apikey='

{
  "status": "OK",
  "data": [
    {
      "epoch": 398940,
      "income": {
        "attestation_head_reward": 1024,
        "attestation_source_penalty": 0,
        "attestation_source_reward": 2048,
        "attestation_target_penalty": 0,
        "attestation_target_reward": 3072,
        "finality_delay_penalty": 0,
        "proposals_missed": 0,
        "proposer_attestation_inclusion_reward": 512,
        "proposer_slashing_inclusion_reward": 0,
        "proposer_sync_inclusion_reward": 0,
        "slashing_penalty": 0,
        "slashing_reward": 0,
        "sync_committee_penalty": 0,
        "sync_committee_reward": 0,
        "tx_fee_reward_wei": "470167509840"
      },
      "validatorindex": 1815428,
      "week": 253,
      "week_start": "2025-10-07T12:00:23Z",
      "week_end": "2025-10-14T12:00:23Z"
    }
  ]
}

Validators

Validator income detail history

Retrieve a per-epoch income breakdown for one or more validators over a bounded epoch window. Provide validator identifiers as a comma-separated list in the path parameter (indices or 0x-prefixed BLS pubkeys, up to the server-enforced limit; default 100). The window ends at latest_epoch (defaults to the latest finalized epoch) and spans limit epochs backwards. You can shift the window back in time by setting offset, which reduces latest_epoch by the given number of epochs. The response includes consensus-layer rewards/penalties in gwei and execution tips in wei (tx_fee_reward_wei).

GET

api

validator

{indexOrPubkey}

incomedetailhistory

Validator income detail history

curl --request GET \
  --url 'https://beaconcha.in/api/v1/validator/{indexOrPubkey}/incomedetailhistory?apikey='

{
  "status": "OK",
  "data": [
    {
      "epoch": 398940,
      "income": {
        "attestation_head_reward": 1024,
        "attestation_source_penalty": 0,
        "attestation_source_reward": 2048,
        "attestation_target_penalty": 0,
        "attestation_target_reward": 3072,
        "finality_delay_penalty": 0,
        "proposals_missed": 0,
        "proposer_attestation_inclusion_reward": 512,
        "proposer_slashing_inclusion_reward": 0,
        "proposer_sync_inclusion_reward": 0,
        "slashing_penalty": 0,
        "slashing_reward": 0,
        "sync_committee_penalty": 0,
        "sync_committee_reward": 0,
        "tx_fee_reward_wei": "470167509840"
      },
      "validatorindex": 1815428,
      "week": 253,
      "week_start": "2025-10-07T12:00:23Z",
      "week_end": "2025-10-14T12:00:23Z"
    }
  ]
}

Authorizations

apikey

string

query

required

Path Parameters

indexOrPubkey

string

required

Comma-separated validator indices and/or public keys (maximum 100 items by default). Comma-separated list (no spaces) of validator identifiers. Each identifier must be either:

A validator index as a base-10 integer (for example, 652648)
A BLS public key as a 96-hex-character string with or without the 0x prefix (case-insensitive)

Resolution and limits:

The server resolves public keys to validator indices before querying data.
The total number of identifiers must not exceed the server-enforced limit (default 100).
Identifiers that cannot be parsed or resolved result in HTTP 400.

Example:

"1,2,3"

Query Parameters

latest_epoch

integer

Most recent epoch to include (inclusive). Defaults to the latest finalized epoch. Must be less than or equal to the latest finalized epoch at request time.

Required range: x >= 0

Example:

399359

offset

integer

default:0

Number of epochs to skip backwards from latest_epoch before starting the window. Must be non-negative and not exceed latest_epoch.

Required range: x >= 0

Example:

0

limit

integer

default:100

Number of epochs to return in the window. Allowed range is 1 to 100. Defaults to 100.

Required range: 1 <= x <= 100

Example:

50

Response

Income details were retrieved successfully. The data array contains one entry per validator per epoch within the requested window. Items are sorted by epoch (descending) and then by validator index (ascending).

Standard success envelope used by all API endpoints.

status

enum<string>

HTTP-independent status of the API operation. For successful responses this is always "OK".

Available options:

OK

data

object[]

Response payload specific to the endpoint.

Show child attributes

data.epoch

integer

Epoch number this income record belongs to (>= 0).

Required range: x >= 0

Example:

398940

data.income

object

Detailed per-epoch income breakdown for a validator. Unless noted otherwise, all amounts are in gwei.

Show child attributes

data.income.attestation_head_reward

integer

Reward from correct head vote in the attestation, in gwei.

Example:

1024

data.income.attestation_source_penalty

integer

Penalty from incorrect/missed source vote, in gwei (non-positive; represented as unsigned magnitude when stored by some backends).

Example:

0

data.income.attestation_source_reward

integer

Reward from correct source vote in the attestation, in gwei.

Example:

2048

data.income.attestation_target_penalty

integer

Penalty from incorrect/missed target vote, in gwei (non-positive; represented as unsigned magnitude when stored by some backends).

Example:

0

data.income.attestation_target_reward

integer

Reward from correct target vote in the attestation, in gwei.

Example:

3072

data.income.finality_delay_penalty

integer

Penalty due to finality delays in the network (applies during periods with no finality), in gwei.

Example:

0

data.income.proposals_missed

integer

Number of scheduled block proposals the validator missed during this epoch.

Required range: x >= 0

Example:

0

data.income.proposer_attestation_inclusion_reward

integer

Proposer reward for including attestations, in gwei.

Example:

512

data.income.proposer_slashing_inclusion_reward

integer

Proposer reward for including a proposer slashing, in gwei.

Example:

0

data.income.proposer_sync_inclusion_reward

integer

Proposer reward for including a sync committee signature set, in gwei.

Example:

0

data.income.slashing_penalty

integer

Penalty due to being slashed or due to correlations, in gwei.

Example:

0

data.income.slashing_reward

integer

Reward earned from participating in a slashing (as whistleblower/aggregator), in gwei.

Example:

0

data.income.sync_committee_penalty

integer

Penalty from missed/incorrect sync committee participation, in gwei.

Example:

0

data.income.sync_committee_reward

integer

Reward from participating in the sync committee for the epoch, in gwei.

Example:

0

data.income.tx_fee_reward_wei

string

Execution-layer fee reward (priority fees and/or MEV payment) attributed to the validator for this epoch, as a decimal string in wei.

Example:

"470167509840"

data.validatorindex

integer

Validator index (>= 0).

Required range: x >= 0

Example:

1815428

data.week

integer

Epoch-based week number computed as epoch / (EpochsPerDay * 7).

Required range: x >= 0

Example:

253

data.week_start

string<date-time>

Start timestamp (UTC, RFC 3339) of the week containing epoch.

Example:

"2025-10-07T12:00:23Z"

data.week_end

string<date-time>

End timestamp (UTC, RFC 3339) of the week containing epoch.

Example:

"2025-10-14T12:00:23Z"

Validator deposits (execution layer)

Validator proposed blocks

Introduction

API Docs

Validator income detail history

Authorizations

Path Parameters

Query Parameters

Response