Skip to main content
POST
List ETH Validators

Headers

submitter-id
string
required

Email of API user submitting the request

Example:

"api-maker@zodia.io"

Body

application/json
walletIds
string[]
required

Wallets to search validators for. Wallets in this list that are not owned by the calling company are silently excluded from the results, rather than returning an error.

paginationLimit
integer<int32>
default:10
Required range: 0 <= x <= 100
paginationOffset
integer<int32>
default:0
Required range: x >= 0
validatorAddresses
string[]
types
enum<string>[]

ETH validator type. 0x01 is a Regular Payout validator (fixed 32 ETH, consensus rewards automatically swept to the withdrawal wallet). 0x02 is an Auto-Compounding validator (32-2048 ETH, Pectra, consensus rewards compound into the validator balance until the cap is reached).

Available options:
0x01,
0x02
statuses
enum<string>[]

Status of the validator. EXIT_BROADCAST signals that an unstake instruction has been broadcast and beacon-chain confirmation is pending.

Available options:
PENDING_INITIALIZED,
PENDING_QUEUED,
DEPOSITED,
ACTIVE_ONGOING,
EXIT_BROADCAST,
ACTIVE_EXITING,
ACTIVE_SLASHED,
EXITED_SLASHED,
EXITED_UNSLASHED,
WITHDRAWAL_POSSIBLE,
WITHDRAWAL_DONE,
CONSOLIDATION_INITIATED,
CONSOLIDATION_IN_PROGRESS,
CONSOLIDATED
providers
enum<string>[]

Staking provider used for the validator

Available options:
BITWISE_ON_CHAIN,
TWINSTAKE,
BLOCKDAEMON,
FIGMENT,
GALAXY,
PIERTWO
withdrawalWallets
string[]

Filter by withdrawal wallet ID

feeRecipientWallets
string[]

Filter by fee recipient wallet ID

balances
string[]

Filter by validator balance, exact match, in wei

pendingDeposits
string[]

Filter by pending deposit amount, exact match, in wei

sort
object

Allowed values for by: validatorAddress, type, status, provider, balance, pendingDeposit

Response

OK

total
integer<int32>
required
items
object[]
required