Retrieve reward performance details for one or more Ethereum validators over a specified time period. Optionally, request a specific page of results. If there are no results on that page (i.e. page 3 with 50 results per page, but there are only 70 results for the query) an empty response is received.
return: JSON containing reward details for Ethereum validators.
Input Example: getEthValidatorRewards(
account_id=12,
rollup_type=EthValidatorRollup.Date,
start="2024-07-10",
end="2024-07-18",
public_keys=["0xab28...6776a"],
page=1,
size=10
)
-------------------- Response --------------------
{
"FunctionData": {
"network": "mainnet",
"start": "2024-07-10",
"end": "2024-07-18",
"page": 1,
"total": 450,
"data": [
{
"pubkey": "0xab28...6776a",
"validator_index": 120,
"total_eth": 0.1,
"total_wei": "100000000000000000",
"accumulated_rewards": [
{
"accumulated_eth": 0.05,
"accumulated_wei": "50000000000000000",
"type": "CONSENSUS"
},
{
"accumulated_eth": 0.05,
"accumulated_wei": "50000000000000000",
"type": "EXECUTION"
}
],
"rewards_breakdown": [
{
"timestamp": "2024-07-13 23:57:00",
"rewards": [
{
"rewards_eth": 0.05,
"rewards_wei": "50000000000000000",
"type": "CONSENSUS"
},
{
"rewards_eth": 0.05,
"rewards_wei": "50000000000000000",
"type": "EXECUTION",
"is_mev": false,
"mev_relay": null,
"recipient": "0xed48...040e8",
"mev_builder": null,
"slot": 7334780,
"block": 18146690,
"tx_hash": "0x25e3...e73b"
}
]
}
]
}
]
},
"Meta": {
"AccessToken": "cd9b...304f",
"Destination": "0435...32cf",
"Source": "0f62...69d0",
"Time": "2024-07-18 16:35:13.710"
}
}
-------------------- Error Reference --------------------
| Error Type | Error Code | Reason / Description |
|---|
| Backend Response | 1007 | Unknown account id 2 system. |
| Backend Response | 1000 | Galaxy request failed. The response includes the error returned by Galaxy. |
Examples:
// Backend Response — Galaxy error (proxied)
{ "ErrorCode": "1007", "Reason": "Unknown account id 2"}
// Backend Response — Galaxy error (proxied)
{ "ErrorCode": "1000", "Reason": "Galaxy request failed. Reason: {\"error\": [{\"code\": 123, \"message\": \"Some error message\"}]}"}
account_idinteger<p>The user defined GK8 account ID of the validator account to retrieve rewards for. The ETH is deposited from this account’s uMPC address to the Galaxy validator(s) account, and withdrawn from this account to the Impenetrable Vault address. The range is limited to the number of user defined accounts.</p>
rollup_typeinteger<p>The rollup type used to calculate validator rewards. The values are 1 = <code>Epoch</code> or 2 = <code>Date</code>.</p>
startstring<p>The start epoch or date, formatted as "YYYY-MM-DD" UTC, for retrieving reward data.</p>
endstring<p>The end epoch or date, formatted as "YYYY-MM-DD" UTC, for retrieving reward data.</p>
pageinteger<p>(Optional) The specific results page to retrieve. The default is <code>1</code>.</p>
sizeinteger<p>(Optional) The number of results per page, up to 250. Defaults to <code>250</code>.</p>
public_keysarray<p>(Optional) A list of validator public keys for reward retrieval. A maximum of 50 entries are allowed.</p>
customer_idstring<p>(Optional) The staking customer ID to filter validator rewards by.</p>