Retrieve a per-epoch income breakdown for one or more validators. Returns consensus-layer rewards/penalties in gwei and execution-layer tips in wei. Use this to analyze validator earnings over time, including attestation rewards, proposer rewards, penalties, and MEV/tips.
limitintegerNumber of epochs to return in the window. Allowed range is 1 to 100. Defaults to 100.
offsetintegerNumber of epochs to skip backwards from `latest_epoch` before starting the window. Must be non-negative and not exceed `latest_epoch`. Default is 0.
latest_epochintegerMost 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.
index_or_pubkeyRequiredstringComma-separated validator indices and/or public keys (maximum 100 items by default). Accepts: (1) Validator index as a number string (e.g., '1', '2', '100'), or (2) BLS public key with 0x prefix (96 hex characters), or (3) Multiple values comma-separated (e.g., '1,2,3' or '1,0xa…
dataRequiredData from the action execution
errorstringError if any occurred during the execution of the action
successfulRequiredbooleanWhether or not the action execution was successful or not
API key connection. Risk level 2 of 5.
Free Action
No published Skills explicitly reference this Action yet.