Skip to main content
GET
/
api
/
v1
/
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.