Unified Staking Status

This event occurs when there’s a change in the status of a staking session or the staked assets. This might be triggered by:

  • A new deposit to the execution layer's deposit contract sets the status to deposited (while the validator is in the queue)
  • Initial staking where the status changes from pending to active
  • Unstaking or withdrawal of assets where the status changes from active to withdawal or exited
  • Status updates to any additional states, such as unknown

Supported Protocols

  • ethereum/mainnet
  • ethereum/hoodi

Schema

{
  "data": {
    "address": "string",
    "status": "string",
    "timestamp": "integer",
    "metadata": {
      "type": "string"
    }
  }
}
FieldTypeDescription
addressstring(Required) The validator address with the staking status update.
statusstring(Required) The current status of the staking session (e.g. DEPOSITED, ACTIVE, PENDING, WITHDRAWAL, EXITED).
timestampinteger(Required) The UNIX timestamp when the status update occurred.
metadataobjectOptional metadata that provides additional information about the staking status.
metadata.typestringAdditional details about the status event.

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

Example

Ethereum

MainnetHoodi

This example shows a validator that has just deposited into the execution layer's deposit contract and is queued for activation. metadata field names are converted from camelCase to snake_case (e.g. rawStatus becomes raw_status), but the values are passed through unchanged — including balance, which stays in Gwei here rather than being converted to wei. Other status values you may see include ACTIVE, PENDING, WITHDRAWAL, and EXITED.

{
  "event_type": "unified_staking_status",
  "protocol": "ethereum",
  "network": "mainnet",
  "chain_id": "eip155:1",
  "data": {
    "address": "0x985916e293c3ea0a1ee799def215f3e470a94ce905962ff039dd2596d6e1ce64d55021f7b81e7f1d4b1b988f95d7ffce",
    "status": "DEPOSITED",
    "timestamp": 1712950487,
    "metadata": {
      "raw_status": "deposited",
      "balance": "32106455974",
      "index": "1315625"
    }
  }
}

👋 Need Help?

Contact us through email or our support page for any issues, bugs, or assistance you may need.


Did this page help you?