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.

Network

• network
  • string
  • enum
  • required
  • Allowed: mainnet, hoodi

Withdrawal Address

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

Groups

• groups
  • string
  • Filter using comma-separated group uuids.

Region

• region
  • string
  • enum
  • The validator's geographic region. Only for Figment validators.
  • Allowed: ca-central-1, eu-west-1

Status

• status
  • string
  • enum
  • The current validator's status. See Lifecycle of a Validator.
  • Allowed:
    • active_ongoing
    • provisioned
    • funding_requested
    • deposited_not_finalized
    • deposited
    • pending_initialized
    • pending_queued
    • active_exiting
    • active_ongoing
    • active_slashed
    • exited_slashed
    • exited_unslashed
    • withdrawal_done
    • withdrawal_possible

Net Fee Payout Address

• net_fee_payout_address
  • string
  • The ETH wallet address that receives the net execution layer rewards.

Staking Request ID

• staking_request_id
  • string
  • The ID associated to the request for a set of validators.

Credentials Prefix

• credentials_prefix
  • string
  • enum
  • Filter for withdrawal_credentials field.
  • Allowed: 0x01, 0x02

Include Fields

• include_fields
  • array of strings
  • A comma-separated list of additional objects to include in the response.
  • Allowed: deposit_data, status_history, status_estimates, on_demand_exit, exit_message, staking_request, balances

Response Structure

200 Validators List

• data
  • array of objects
  • Each object contains:
    • id: string (UUID for the validator)
    • index: integer or null (Validator's on-chain index)
    • network: string (enum)
    • pubkey: string (the pubkey for the validator, prefixed with 0x)
    • withdrawal_address: string
    • status: string or null (current status of the validator)
    • withdrawal_credentials: string or null
    • fee_recipient_address: string or null
    • net_fee_payout_address: string or null
    • region: string or null
    • deposit_data: object or null
    • status_history: object or null
    • status_estimates: object or null
    • on_demand_exit: object or null
    • exit_message: object or null
    • staking_request: object or null
    • balances: object or null

Meta Object

• meta
  • pagination: object
• pagination
  • current_page: integer
  • total_pages: integer
  • total_item_count: integer

Example Request

curl --request GET \
  --url 'https://api.figment.io/ethereum/validators?network=mainnet' \
  --header 'accept: application/json' \
  --header 'x-api-key: your-api-key-here'

Example Response

{
  "data": [
    {
      "id": "29d3a221-8de7-4874-9973-35ac1e70b87b",
      "network": "hoodi",
      "pubkey": "0xb121633094a5e75b886eeba797d43e80e4a6003462921f175aed2f112a460d09447f3c484f067c13b100b763070857b3",
      "withdrawal_address": "0xE40F80618324C814cD444434670a44ba4583aE38",
      "withdrawal_credentials": "0x010000000000000000000000e40f80618324c814cd444434670a44ba4583ae38",
      "net_fee_payout_address": "0xE40F80618324C814cD444434670a44ba4583aE38",
      "fee_recipient_address": "0xE40F80618324C814cD444434670a44ba4583aE38",
      "status": "deposited",
      "region": "ca-central-1",
      "index": null,
      "staking_request": {
        "id": "817c04a2-3d5b-4222-81c8-2de77f0be7db",
        "created_at": "2023-10-17T18:35:30Z"
      },
      "status_history": {
        "events": [
          {
            "status": "provisioned",
            "changed_at": "2023-10-17T18:35:31Z"
          },
          {
            "status": "deposited_not_finalized",
            "changed_at": "2023-10-17T20:38:36Z"
          },
          {
            "status": "deposited",
            "changed_at": "2023-10-17T20:51:36Z"
          }
        ]
      },
      "deposit_data": {
        "signature": "0xb7a8703d0ff4865174525c760509a18c5cdc4a321612d865b995d9ba60a9519703d3f7be1527e89041dbea886cb3b26a0d1a13976405b93301cdb16a54258ec3ac891e738ad73e68c6a6a09b286f8c8c71005eb8e55d144ee59fa7c311ac3dea",
        "figment_signature": "0x308187024201cc42b16a0264b3853e123034f21ef7fc1d75b96bc8ae13427836475838c447f90e19a8e3926fe3d20bc91da4d720f886ef3eb3f35ed164674bb6cab2c216329c2002411392c3c6a70bf5f3df0ed3d092d28dbed24933d4ab150ec1ee60cba79d72d374572a04161d5f47be6485353fd78a4c04cc4f3a7bdcc9e3ae749419cc35bc3f6a13",
        "deposit_data_root": "0x8d0b864a077b06044d2336264aaf8efbd03dd61ab0a8074bfb811b7f5c10146e",
        "deposit_message_root": "0x5163474c33dcf5b6fb0bafcaa6a1edbe264de7c9eca6dc5358bee6c21bfc2fef",
        "fork_version": "0x01017000",
        "amount": 32000000000,
        "deposit_cli_version": "2.7.0"
      },
      "status_estimates": {
        "estimated_active_at": "2023-10-18T16:21:20Z",
        "estimated_exit_at": null,
        "estimated_withdrawal_at": null
      },
      "on_demand_exit": {
        "requested_at": null,
        "approved_at": null,
        "submitted_at": null,
        "request_id": null
      },
      "exit_message": {
        "encrypted_value": null,
        "fork_version": null
      },
      "balances": {
        "actual": "0.0",
        "pending_deposit": "32.0",
        "pending_topups": "0.0",
        "pending_withdrawals": "0.0"
      }
    }
  ],
  "meta": {
    "pagination": {
      "current_page": 1,
      "total_pages": 20,
      "total_item_count": 100
    }
  }
}