Unified Staking Reward

This event is triggered whenever a staking reward is issued or distributed. The conditions that might trigger this include:

Rewards are calculated and distributed at the end of a staking period or epoch.
A system update that includes reward payouts based on the amount staked and the duration of staking. It also includes any withdrawals and deposits made during the epoch.

Supported Protocols

ethereum/mainnet
ethereum/hoodi

Schema

{
  "data": {
    "address": "string",
    "start_balance": "integer",
    "return": "integer",
    "start_time": "integer",
    "end_time": "integer",
    "period": "string",
    "metadata": {
      "type": "string"
    }
  }
}

Field	Type	Description
`address`	string	(Required) The validator address that receives the reward.
`start_balance`	integer	(Required) The validator's balance at the start of the staking period, in wei.
`return`	integer	(Required) The reward amount issued based on the staking period and amount, in wei.
`start_time`	integer	The UNIX timestamp when the staking period begins.
`end_time`	integer	The UNIX timestamp when the staking period ends.
`period`	string	A label that indicates the duration of the staking period (e.g. `RAW`, `daily`, `weekly`, `monthly`).
`metadata`	object	Optional metadata that provides additional information about the staking reward.
`metadata.type`	string	Additional details about the reward event.

This schema applies to the UNIFIED_V1 and UNIFIED_V1_RAW templates. ALL_DATA returns Ethereum's native staking reward payload unmodified, with its own fields.

📘
Info
return and start_balance are converted to wei in the unified schema. The raw payload's denomination field indicates the unit of its own return and startBalance values (in this example, WEI, though the raw values shown are actually denominated in Gwei — see the note in the example below).

Example

Ethereum

MainnetHoodi

This example shows a per-epoch validator reward (period: RAW). The raw payload's return and startBalance are labeled denomination: WEI, but the numeric values shown are actually in Gwei (Ethereum's consensus-layer reward accounting unit); the unified schema converts both to true wei by multiplying by 1e9, so return goes from 31338 to 31338000000000 and start_balance from 32106455974 to 32106455974000000000. metadata field names are also converted from camelCase to snake_case, but their values are passed through unchanged.

{
  "event_type": "unified_staking_reward",
  "protocol": "ethereum",
  "network": "mainnet",
  "chain_id": "eip155:1",
  "data": {
    "address": "0x985916e293c3ea0a1ee799def215f3e470a94ce905962ff039dd2596d6e1ce64d55021f7b81e7f1d4b1b988f95d7ffce",
    "return": 31338000000000,
    "start_time": 1712950487,
    "end_time": 1712950871,
    "start_balance": 32106455974000000000,
    "period": "RAW",
    "metadata": {
      "epoch": "276371",
      "withdrawals": "0",
      "deposits": "0",
      "index": "1315625",
      "sync_committee_reward": "21626",
      "block_reward": "0",
      "attestation_reward": "9712",
      "mev_block_reward": "487222411021093440"
    }
  }
}

Supported Protocols

Schema

Info

Example

Ethereum

👋 Need Help?