Alchemy Logo

/v1/beacon/states/{state_id}/validators

GET
https://eth-mainnetbeacon.g.alchemy.com/v2/docs-demo/eth/v1/beacon/states/{state_id}/validators

Returns a filterable list of validators with their balance, status, and index. Information will be returned for all indices or public keys that match known validators. If an index or public key does not match any known validator, no information will be returned, but this will not cause an error. The response does not guarantee ordering, so both the index and pubkey can be used to confirm inputs.

Path Parameters

state_idstringrequired

State identifier. Can be one of: head (canonical head in node's view), genesis, finalized, justified, <slot>, <hex encoded stateRoot with 0x prefix>.

Query Parameters

idstring[]optional

Optional filter: validator index or hex-encoded public key (bytes48 with 0x prefix). Multiple values can be provided.

statusstring[]optional

Optional filter: restrict results to validators with the given status. Status values include: pending_initialized, pending_queued, active_ongoing, active_exiting, active_slashed, exited_unslashed, exited_slashed, withdrawal_possible, withdrawal_done.

Responses

200

Validator details for the given state.

Was this page helpful?