๐ Transaction Withdrawals
Returns the EIP-7002 withdrawal requests that an execution layer transaction made, identified by its hash: full exits and partial withdrawals, each with the validator it names, the amount it asks for, its sender and fee, what the consensus layer did with it, the amount it paid and the slots that did it.
A transaction can make many requests, for example through a contract that exits a batch of validators. Results are ordered by the requestโs position in the transaction and paginated.
The consensus layer picks the requests up out of the execution-layer request contract, which releases at most 16 withdrawal requests per block. The requests of a large transaction therefore reach the consensus layer over several blocks, and a request can wait in the contract behind earlier ones. What the consensus layer did with a request shows here once the slot that did it is finalized. Until then the request is queued with queued_slot and processed_slot both null.
type | status | queued_slot | processed_slot |
|---|---|---|---|
| either | queued, not picked up, or picked up in a slot not finalized yet | null | null |
full_exit | completed, the validatorโs exit started | null | the slot that started the exit |
full_exit | rejected | null | the slot that rejected it |
partial_withdrawal | queued, in the pending partial withdrawal queue | the slot that queued it | null |
partial_withdrawal | completed, paid | the slot that queued it | the slot that paid it |
partial_withdrawal | rejected when picked up | null | the slot that rejected it |
partial_withdrawal | rejected when its turn in the queue came | the slot that queued it | the slot that dropped it |
Once every entry of a response is finalized, its outcomes and slots no longer change; validator.index can still appear later, when the public key of a request rejected for an unknown key gets a validator, and is_contract follows each addressโs current state.
You can combine this endpoint with:
- The validatorโs exit epoch, withdrawable epoch and status: v2/ethereum/validators
- The block that included the transaction: v2/ethereum/block
- The slots that queued and processed the requests: v2/ethereum/slot
The response is 404 when the transaction made no withdrawal request, or when it is not indexed yet, as for a short time after its block.
Premium Endpoint: This endpoint requires a Scale or Enterprise plan.
Authorizations
Body
cursor and page_size are optional in this request body
Hash of the execution layer transaction that made the withdrawal requests, as a 0x-prefixed hex string.
^0x[a-fA-F0-9]{64}$The Ethereum chain to query.
mainnet, hoodi Cursor value for pagination. See our pagination guide for more details.
The number of items to return per page.
1 <= x <= 10
