๐ Transaction Deposits
Returns the deposits that an execution layer transaction made through the deposit contract, identified by its hash: each with the validator it is for, its withdrawal credentials, its amount and sender, what the consensus layer did with it and the slots that did it.
A transaction can make many deposits, for example through a contract that deposits for a batch of validators. Results are ordered by the depositโs position in the transaction and paginated.
What the consensus layer did with a deposit shows here once the slot that did it is finalized. Until then the deposit is queued with queued_slot and processed_slot both null.
| Deposit | status | queued_slot | processed_slot |
|---|---|---|---|
| Not picked up yet, or picked up in a slot that is not finalized yet | queued | null | null |
| Waiting in the pending deposit queue | queued | the slot that queued it | null |
| Processed | completed | the slot that queued it, or that last put it back at the end of the queue for a postponed deposit | the slot that processed it |
| Rejected | rejected | the slot that queued it | the slot that rejected it |
| Moved into the builder registry by the Glamsterdam fork upgrade | onboarded | the slot that queued it | the last slot before the fork |
| Included before Electra | completed or rejected | null | the slot whose block included it |
| Made before genesis, processed by the genesis state | completed or rejected | null | 0 |
validator.index is null until the consensus layer processes the first valid deposit of the public key, which creates its validator.
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 rejected deposit gets a validator, and is_contract follows each addressโs current state.
You can combine this endpoint with:
- The signature, type, validity and reject reason of a deposit: v2/ethereum/slot/deposits at
processed_slotwith the public key asvalidator, or for a deposit in the queue atqueued_slotwithstage: consensus_layer_queued - The validatorโs status, balance and activation: v2/ethereum/validators, once it has an index
- When a deposit in the queue is estimated to be processed, also for a public key without an index: v2/ethereum/validators/queues. A postponed deposit has no estimate there: it waits until its exiting validator can withdraw
- The block that included the transaction: v2/ethereum/block
- The slots that queued and processed the deposits: v2/ethereum/slot
The response is 404 when the transaction made no deposit, 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 deposits, 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
