Retrieve withdrawal transactions for Ethereum validators within a specified time range. This endpoint provides information about both partial withdrawals (rewards) and full withdrawals (validator principal) that have been processed by the Ethereum network.
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.
Input example: getEthValidatorWithdrawals(
account_id=12
rollup_type=EthValidatorRollup.Date,
start="2024-01-05",
end="2024-01-10",
public_keys=["0xab28...6776a"]
)
Return: JSON object containing validator withdrawal details.
-------------------- Response --------------------
{
"FunctionData": {
"network": "mainnet",
"start": "2024-01-05",
"end": "2024-01-10",
"page": 1,
"total": 275,
"data": [
{
"pubkey": "0xab28...6776a",
"validator_index": 120,
"withdrawal_address": "0x793a...3BEe",
"withdrawal_credential_type": "0x01",
"is_full_withdrawal": false,
"withdrawal_amount_eth": 0.1,
"withdrawal_amount_wei": 100000000000000000,
"epoch": 200070,
"timestamp": "2024-01-10 12:45:00",
"slot": 653848,
"block": 12224322
}
]
},
"Meta": {
"AccessToken": "e3c7...f9a1",
"Destination": "0435...32cf",
"Source": "0f62...69d0",
"Time": "2024-01-10 14:12:30"
}
}
-------------------- Error Reference --------------------
| Error Type | Error Code | Reason / Description |
|---|
| Backend Response | 1007 | No validators matching the provided filters were found in the 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 ID of the account to retrieve validator withdrawals for.The user defined GK8 account ID to retrieve validator withdrawals 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 type of rollup aggregation to apply to the response. The type of rollup to use for the rewards calculation. Applicable values are <code>1</code> (epoch), <code>2</code> (date).</p>
startstring<date><p>The start of the withdrawal query period, formatted as <code>YYYY-MM-DD UTC</code>.</p>
endstring<date><p>The end of the withdrawal query period, formatted as <code>YYYY-MM-DD UTC</code>.</p>
pageinteger<p>(Optional) Set the specific results page to retrieve. Defaults to "1".</p>
sizeinteger<p>(Optional) The number of results per page, up to "250". Defaults to "250".</p>
public_keysarray<p>(Optional) A list of validator public keys to filter the results. A maximum of 50 entries are allowed.</p>
customer_idstring<p>(Optional) The ID of the customer associated with the validators.</p>