Get Validators

Returns all Figment validators, or a filtered subset thereof, for your organization (via API key) created through the Create Validators endpoint.

Use the get-validator endpoint if you only want information on one single validator.

Use include_fields to get extra information. e.g. To get the presigned exit messages for the validators, append ?include_fields=exit_message.

A few noteworthy response fields:

  • status: refer to the Lifecycle of a Validator guide
  • status_history returns an array of all status transitions.
  • estimates for:
    • when a validator will become active (estimated_active_at)
    • when it will exit (estimated_exit_at)
    • and when the principal will be withdrawable (estimated_withdrawal_at)

Note: If you are restaking via Eigenlayer, your withdrawal address is set to your EigenPod address.

Query Params
string
enum
required
Allowed:
string

The validator's withdrawal address. Must be prefixed with 0x.

string

Filter using comma-separated group uuids.

string
enum

The validator's geographic region. Only for Figment validators.

Allowed:
string
enum

The current validator's status. See https://docs.figment.io/docs/lifecycle-eth-validator.

string

The ETH wallet address that receives the net execution layer rewards (when they go through a fee splitting smart contract).

string

The ID associated to the request for a set of valdiators.

string
enum

Filter for withdrawal_credentials field

Allowed:
include_fields
array of strings

A comma-separated list of additional objects to include in the response.

include_fields
Allowed:
page
object
Responses

401

Invalid API key

Language
LoadingLoading…
Response
Choose an example:
application/json