Ethereum | Galaxy Staking

Provision Validators

post

The staking endpoint must be invoked by the client to facilitate the staking action. When a request to provision more than 100 validators is received, it will be split into batches, each containing a maximum of 100 validators, and then processed. A total of 1,000 validators can be provisioned per request, across 10 batches.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

client_req_idstringRequired

A unique identifier for the staking request generated by the client.

Example: 49bf80cb-c7ca-4082-a526-8afab545cc62

networkstring · enumRequired

The network on which validators should be created. Supported values are;

mainnet
hoodi

Possible values:

withdrawal_credentials_typeundefined · enumOptional

The withdrawal credential type of the validator(s) to be created. Supported values are;

0x01 (Default)
0x02

Default: 0x01Example: 0x02Possible values:

amounts_unitundefined · enumOptional

The unit in which the staking amount is specified for withdrawal_credential_type = 0x02 validators in the amounts field. Supported values are:

ETH
GWEI

Conditionally required if the withdrawal_credential_type = 0x02.

Example: ETHPossible values:

amountsinteger · int32[]Optional

The Ethereum amounts to be staked, specified in either ETH or GWEI. This is required if the withdrawal credentials type is 0x02.

When specified in ETH, up to 9 decimal places are supported.
When specified in GWEI, only whole numbers are supported.
Any additional decimal places will be ignored.

Example: 40

validator_countinteger · int32Required

The number of validators required. A maximum of 1000 validators are supported

Example: 1

withdrawal_addressstringRequired

The ETH account (wallet) used for the withdrawal credentials of the validators. This is the address that will receive consensus rewards and unstaked ETH after exiting.

Example: 0x1D1479C185d32EB90533a08b36B3CFa5F84A0E6B

fee_recipient_addressstringOptional

The ETH account (wallet) that will receive the execution layer rewards. If not provided, this will be defaulted to the withdrawal address.

Example: 0x1D1479C185d32EB90533a08b36B3CFa5F84A0E6B

regionstring · enumOptional

The geographic region where the validator will be created. Supported values are;

US
EU (Default)
KR

Default: EUPossible values:

accountstringOptional

The account name registered on the platform that is associated with the client's customer. If not provided, requests will be assigned to a default account.

Example: BR_Account3

Responses

200

Sample success response payload. See Response schema below for wrapper

application/json

client_req_idstringOptional

The client_req_id of the staking request addressed by this response message.

Example: 49bf80cb-c7ca-4082-a526-8afab545cc62

staking_ref_idstringOptional

A unique reference ID generated by the staking infrastructure for the staking request.

Example: 59bf80cb-c7ca-4082-a526-8afab545cc62

networkstring · enumOptional

The network on which validators should be created. Supported values are;

mainnet
hoodi

Example: mainnetPossible values:

withdrawal_credentials_typeundefined · enumOptional

The withdrawal credential type of the validator(s) that will be created. Applicable values are;

0x01
0x02

Example: 0x02Possible values:

withdrawal_addressstringOptional

The specified address to which funds will be withdrawn, as mentioned in the staking request.

Example: 0x1D1479C185d32EB90533a08b36B3CFa5F84A0E6B

fee_recipient_addressstringOptional

The fee recipient address that receives Execution Layer fees, as mentioned in the staking request.

Example: 0x1D1479C185d32EB90533a08b36B3CFa5F84A0E6B

regionstring · enumOptional

The geographic region where the validator will be created. Supported values are;

US
EU
KR

Example: USPossible values:

provisioned_atstring · date-timeOptional

The date and time when the validator was provisioned by the staking infrastructure.

Example: 2025-05-04 10:25:24

400

Bad Request

application/json

500

Internal Server Error

application/json

post

/v1/ethereum/validators

POST /v1/ethereum/validators HTTP/1.1
Host: localhost
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 342

{
  "client_req_id": "49bf80cb-c7ca-4082-a526-8afab545cc62",
  "network": "mainnet",
  "withdrawal_credentials_type": "0x02",
  "amounts_unit": "ETH",
  "amounts": [
    40
  ],
  "validator_count": 1,
  "withdrawal_address": "0x1D1479C185d32EB90533a08b36B3CFa5F84A0E6B",
  "fee_recipient_address": "0x1D1479C185d32EB90533a08b36B3CFa5F84A0E6B",
  "region": "EU",
  "account": "BR_Account3"
}

{
  "client_req_id": "49bf80cb-c7ca-4082-a526-8afab545cc62",
  "staking_ref_id": "59bf80cb-c7ca-4082-a526-8afab545cc62",
  "network": "mainnet",
  "withdrawal_credentials_type": "0x02",
  "withdrawal_address": "0x1D1479C185d32EB90533a08b36B3CFa5F84A0E6B",
  "fee_recipient_address": "0x1D1479C185d32EB90533a08b36B3CFa5F84A0E6B",
  "region": "US",
  "provisioned_at": "2025-05-04 10:25:24",
  "data": [
    {
      "batch_id": 1,
      "deposit_data": [
        {
          "pubkey": "0xb5d1110cb4e7cda0d4f3390b29e7bc7e07bb63490eeb78782d70997991c7d9901befa9dd8955f2bd574aa0bd524fbc14",
          "amount": 40000000000,
          "withdrawal_credentials": "02000000000000000000000000x1D1479C185d32EB90533a08b36B3CFa5F84A0E6B",
          "signature": "ad7e6e09743d9912bb3639d00d43b367420f60a65607b7092d36a0312963ecfa866a2b3b90a1b20183b7ef6c9b5c4e3608dc684080e1b7f9fbc6f71c3dd30c711eb63a68d5cb12c5007dd3b2cc0106cc2c7c96bc79acf5ee119c9f16288fda47",
          "deposit_data_root": "940f83319b35eb39475bf4e963d540da685a389bb5b05cafa52f47fb462c2844",
          "deposit_message_root": "88c4d10991623845ef99fec1796cb04b406652d12c3918f7f27089d1331e2007",
          "fork_version": "10000910",
          "deposit_cli_version": "2.7.0"
        }
      ],
      "deposit_transaction": {
        "deposit_amount_wei": "40000000000000000000",
        "deposit_address": "0xc8b600A20d10f513bf7E879058EFDEeB7E646b0b",
        "contract_call_data": "0x4f498c7300000......"
      }
    }
  ]
}

Exit Validators

post

The exit endpoint enables clients to initiate validator withdrawals by broadcasting voluntary exit messages to the beacon chain. It can be enabled in three ways.

Validator Public Keys: Exit from the network using the specified validator public addresses.
Validator Indexes: Exit from the network using the specified validator indexes.
Withdrawal Address with Validator Count: Exit from the network using the specified withdrawal address and validator count. Only type 0x01 validators can be exited using this method.

Each request type can handle exiting only up to 250 validators at once.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

client_req_idstringRequired

A unique identifier generated and sent by the client for the exit request. Refer Client Request Identifier for further details.

Example: 79bf80cb-c7ca-4082-a526-8afab545cc62

networkstring · enumRequired

The network on which validators were created. Supported values are;

mainnet
hoodi

Possible values:

typeinteger · enumRequired

Indicates the type of attribute used to identify the validators to exit. The possible values are,

1 (pubkey)
2 (validator_index)
3 (withdrawal_address)

Example: 1Possible values:

pubkeysstring[]Optional

List of validator public keys to be exited. This is required if the exit type is 1. A maximum of 250 public keys can be specified.

Example: 0x904144048d9845d83adac25e94d63f8ccd4a04e71f0c4440ce5b08d30e0851ddb209f2cca32a987d953d4901b409f8b4

validator_indexesinteger · int32[]Optional

The list of validator indexes to be exited. Required if exit type is 2. A maximum of 250 validator indexes can be specified.

Example: 1142745

withdrawal_addressstringOptional

The withdrawal address of the validators that should be exited. Required if exit type is 3

Example: 0x793aA4ea0Cb9fBBF0033320C3F3795ef713a3BEe

validator_countinteger · int32Optional

Required if exit type is 3. The Max count should be 250.

Example: 1

Responses

200

Sample success response payload. See Response schema below for wrapper

application/json

client_req_idstringOptional

Unique identifier specified in the request.

Example: 49bf80cb-c7ca-4082-a526-8afab545cc62

networkstring · enumOptional

Network specified in the request. Supported values are;

mainnet
hoodi

Possible values:

400

Bad Request

application/json

500

Internal Server Error

application/json

post

/v1/ethereum/validators/exit

POST /v1/ethereum/validators/exit HTTP/1.1
Host: localhost
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 314

{
  "client_req_id": "79bf80cb-c7ca-4082-a526-8afab545cc62",
  "network": "mainnet",
  "type": 1,
  "pubkeys": [
    "0x904144048d9845d83adac25e94d63f8ccd4a04e71f0c4440ce5b08d30e0851ddb209f2cca32a987d953d4901b409f8b4"
  ],
  "validator_indexes": [
    1142745
  ],
  "withdrawal_address": "0x793aA4ea0Cb9fBBF0033320C3F3795ef713a3BEe",
  "validator_count": 1
}

{
  "client_req_id": "49bf80cb-c7ca-4082-a526-8afab545cc62",
  "network": "mainnet",
  "data": [
    {
      "pubkey": "0xb794f5ea0ba39494ce839613fffba74279579268",
      "validator_index": 1142745,
      "withdrawal_address": "0x793aA4ea0Cb9fBBF0033320C3F3795ef713a3BEe",
      "status": "EXIT_INITIATED"
    }
  ]
}

Derive Pre-Signed Exit Message

post

The pre-signed exit endpoint enables clients to request pre-signed exit messages for validators. When clients decide to exit their validators, the pre-signed exit message can be independently broadcasted to the consensus node. The validators must be in an active state for at-least 256 epochs in order to derive the encrypted pre-signed exit message. Before calling this endpoint, the client must create an RSA4096 key pair.This is a separate key pair from the one used for JWT signature generation.The client needs to share the public key from this new key pair with the platform. The platform will use this public key to encrypt the pre-signed exit message with the RSA_OAEP_SHA_256 algorithm.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

client_req_idstringRequired

A unique identifier generated and sent by the client for the exit request. Refer Client Request Identifier for further details.

Example: 79bf80cb-c7ca-4082-a526-8afab545cc62

networkstring · enumRequired

The network on which validators were created. Supported values are;

mainnet
hoodi

Possible values:

typeinteger · enumRequired

Indicates the type of attribute used to identify the validators to exit. The possible values are,

1 (pubkey)
2 (validator_index)
3 (withdrawal_address)

Example: 1Possible values:

pubkeysstring[]Optional

List of validator public keys to be exited. This is required if the exit type is 1. A maximum of 250 public keys can be specified.

Example: 0x904144048d9845d83adac25e94d63f8ccd4a04e71f0c4440ce5b08d30e0851ddb209f2cca32a987d953d4901b409f8b4

validator_indexesinteger · int32[]Optional

The list of validator indexes to be exited. Required if exit type is 2. A maximum of 250 validator indexes can be specified.

Example: 1142745

withdrawal_addressstringOptional

The withdrawal address of the validators that should be exited. Required if exit type is 3

Example: 0x793aA4ea0Cb9fBBF0033320C3F3795ef713a3BEe

validator_countinteger · int32Optional

Required if exit type is 3. The Max count should be 250.

Example: 1

Responses

200

Sample success response payload. See Response schema below for wrapper

application/json

networkstring · enumOptional

Network specified in the request.

Possible values:

400

Bad Request

application/json

500

Internal Server Error

application/json

post

/v1/ethereum/validators/exit/pre-signed

POST /v1/ethereum/validators/exit/pre-signed HTTP/1.1
Host: localhost
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 314

{
  "client_req_id": "79bf80cb-c7ca-4082-a526-8afab545cc62",
  "network": "mainnet",
  "type": 1,
  "pubkeys": [
    "0x904144048d9845d83adac25e94d63f8ccd4a04e71f0c4440ce5b08d30e0851ddb209f2cca32a987d953d4901b409f8b4"
  ],
  "validator_indexes": [
    1142745
  ],
  "withdrawal_address": "0x793aA4ea0Cb9fBBF0033320C3F3795ef713a3BEe",
  "validator_count": 1
}

{
  "network": "mainnet",
  "data": [
    {
      "pubkey": "0x904144048d9845d83adac25e94d63f8ccd4a04e71f0c4440ce5b08d30e0851ddb209f2cca32a987d953d4901b409f8b4",
      "validator_index": 1142745,
      "withdrawal_address": "0x793aA4ea0Cb9fBBF0033320C3F3795ef713a3BEe",
      "encrypted_exit_message": "ab28a95b78913394e2a345e0e5866add7ed7e3fb7a512a7e36451a8b2b95439ccde878eaa4d31fedd6e684b04006776artrtrtrtrt..",
      "fork_version": "00000000",
      "status": "ACTIVE"
    }
  ]
}

Get All Validators or by Staking Reference ID

get

The get all validators endpoint returns the details of the validators provisioned for the given client for the specified network in a paginated manner. This endpoint can also be used to return the details of the validators belonging to the given client for the specified network and staking reference ID. All timestamp fields in the response are provided in UTC timezone.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

networkstringRequired

Applicable values are mainnet and hoodi

Query parameters

pagestringOptional

The current page number requested by the client, if not specified, should be defaulted to 1.

sizestringOptional

The number of entries per page, if not presented in the request, should be defaulted to the maximum value of 250.

staking_ref_idstringOptional

The staking reference ID returned for the staking request.

include_presigned_exitstringOptional

This indicates whether the pre-signed exit message to be included in the response or not. It’s a boolean parameter, defaulted to "false".

Responses

200

Sample success response payload. See Response schema below for wrapper

application/json

networkstring · enumOptional

Network specified in the request.

Possible values:

pageinteger · int32Optional

The current page number sent in the request.

Example: 1

totalinteger · int32Optional

Total number of validators provisioned for the given client and the network.

Example: 1

400

Bad Request

application/json

500

Internal Server Error

application/json

get

/v1/ethereum/{network}/validators

GET /v1/ethereum/{network}/validators HTTP/1.1
Host: localhost
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "network": "mainnet",
  "page": 1,
  "total": 1,
  "data": [
    {
      "epoch": 427017,
      "status": "STAKING_INITIATED",
      "pubkey": "0xb794f5ea0ba39494ce839613fffba74279579268",
      "region": "US",
      "validator_index": 10000,
      "withdrawal_credential_type": "0x01",
      "withdrawal_address": "0x793aA4ea0Cb9fBBF0033320C3F3795ef713a3BEe",
      "fee_recipient_address": "0x793aA4ea0Cb9fBBF0033320C3F3795ef713a3BEe",
      "estimated_activation_at": "2022-01-12 13:23:23",
      "estimated_exit_at": "2024-08-12 13:23:23",
      "estimated_withdrawal_at": "2024-09-12 13:23:23",
      "balance_in_wei": "32500000000000000000",
      "balance_in_eth": 32.5,
      "status_history": [
        {
          "status": "STAKING_INITIATED",
          "transitioned_at": "2022-01-05 13:22:23"
        }
      ],
      "voluntary_exit": {
        "request_id": "8a075b89-c1f7-4381-a158-8ee866bf68bc",
        "requested_at": "2024-08-12 11:21:23",
        "submitted_at": "2024-08-12 11:21:23"
      },
      "presigned_exit": {
        "fork_version": "00000000",
        "encrypted_exit_message": "ab28a95b78913394e2a345e0e5866add7ed                          7e3fb7a512a7e36451a8b2b95439ccde878eaa4d31fedd6                          e684b04006776artrtrtrtrt.."
      },
      "staking_request_info": {
        "staking_ref_id": "8a075b89-c1f7-4381-a158-8ee866bf68bb",
        "provisioned_at": "2022-01-05 13:20:23"
      }
    }
  ]
}

Get a Single Validator

get

The get single validator endpoint returns the validator information for the specified validator’s public key. All timestamp fields in the response are provided in UTC timezone.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

networkstringRequired

Applicable values are mainnet and hoodi.

pubkeystringRequired

The public key of the validator

Query parameters

include_presigned_exitstringOptional

This indicates whether the pre-signed exit message to be included in the response or not. It’s a boolean parameter, defaulted to “false”.

Responses

200

Sample success response payload. See Response schema below for wrapper

application/json

networkstring · enumOptional

The network on which validators were created.

Possible values:

epochinteger · int32Optional

The specific blockchain epoch to which the returned validator details correspond.

Example: 427017

statusstring · enumOptional

Current status of the validator.

Possible values:

pubkeystringOptional

Public key of the validator.

Example: 0xb794f5ea0ba39494ce839613fffba74279579268

regionstring · enumOptional

The geographic region where the validator will be created.

Possible values:

validator_indexinteger · int32Optional

Validator index.

Example: 10000

withdrawal_credential_typestringOptional

Withdrawal credential type of the validator. Applicable values are:

0x00
0x01
0x02

Example: 0x01

withdrawal_addressstringOptional

Withdrawal address of the corresponding validator.

Example: 0x793aA4ea0Cb9fBBF0033320C3F3795ef713a3BEe

fee_recipient_addressstringOptional

The fee recipient address belongs to the validator.

Example: 0x793aA4ea0Cb9fBBF0033320C3F3795ef713a3BEe

estimated_activation_atstringOptional

Estimate of when the validator will become active and start earning rewards. This will be populated since the validator is transitioned to DEPOSITED status. Until then, it will be null. It will be in the format of “YYYY-MM-DD HH:mm:ss”.

Example: 2022-01-12 13:23:23

estimated_exit_atstringOptional

Estimate of when the validator will exit and stop earning rewards. This will be populated since the validator is transitioned to EXIT_INITIATED status. Until then, it will be null. It will be in the format of “YYYY-MM-DD HH:mm:ss”.

Example: 2024-08-12 13:23:23

estimated_withdrawal_atstringOptional

Estimate of when the validator’s principal will become withdrawable. This will be populated since the validator is transitioned to EXITED status. Until then, it will be null. It will be in the format of “YYYY-MM-DD HH:mm:ss”.

Example: 2024-09-12 13:23:23

balance_in_weistringOptional

Current balance of the validator in WEI.

Example: 32500000000000000000

balance_in_ethnumber · doubleOptional

Current balance of the validator in ETH.

Example: 32.5

400

Bad Request

application/json

500

Internal Server Error

application/json

get

/v1/ethereum/{network}/validators/{pubkey}

GET /v1/ethereum/{network}/validators/{pubkey} HTTP/1.1
Host: localhost
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "network": "mainnet",
  "epoch": 427017,
  "status": "STAKING_INITIATED",
  "pubkey": "0xb794f5ea0ba39494ce839613fffba74279579268",
  "region": "US",
  "validator_index": 10000,
  "withdrawal_credential_type": "0x01",
  "withdrawal_address": "0x793aA4ea0Cb9fBBF0033320C3F3795ef713a3BEe",
  "fee_recipient_address": "0x793aA4ea0Cb9fBBF0033320C3F3795ef713a3BEe",
  "estimated_activation_at": "2022-01-12 13:23:23",
  "estimated_exit_at": "2024-08-12 13:23:23",
  "estimated_withdrawal_at": "2024-09-12 13:23:23",
  "balance_in_wei": "32500000000000000000",
  "balance_in_eth": 32.5,
  "status_history": [
    {
      "status": "STAKING_INITIATED",
      "transitioned_at": "2022-01-05 13:22:23"
    }
  ],
  "voluntary_exit": {
    "request_id": "8a075b89-c1f7-4381-a158-8ee866bf68bc",
    "requested_at": "2024-08-12 11:21:23",
    "submitted_at": "2024-08-12 11:21:23"
  },
  "presigned_exit": {
    "fork_version": "00000000",
    "encrypted_exit_message": "ab28a95b78913394e2a345e0e5866add7ed                          7e3fb7a512a7e36451a8b2b95439ccde878eaa4d31fedd6                          e684b04006776artrtrtrtrt.."
  },
  "staking_request_info": {
    "staking_ref_id": "8a075b89-c1f7-4381-a158-8ee866bf68bb",
    "provisioned_at": "2022-01-05 13:20:23"
  }
}

Get Validators Summary

get

This endpoint returns the summary of the validator count by status belonging to the staking partner associated with the given API Key.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

networkstringRequired

Applicable values are mainnet and hoodi.

Responses

200

Sample success response payload. See Response schema below for wrapper

application/json

networkstring · enumOptional

Network specified in the request.

Possible values:

totalinteger · int64Optional

Total number of validators provisioned for the given client and the network.

Example: 10

400

Bad Request

application/json

500

Internal Server Error

application/json

get

/v1/ethereum/{network}/validators/summary

GET /v1/ethereum/{network}/validators/summary HTTP/1.1
Host: localhost
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "network": "mainnet",
  "total": 10,
  "data": [
    {
      "status": "STAKING_INITIATED",
      "count": 10
    }
  ]
}

Withdrawals

post

The withdrawals endpoint returns a history of withdrawals (partial and full) from the consensus layer to the execution layer.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

pagestringOptional

The current page number requested by the client, if not specified, should be defaulted to 1.

sizestringOptional

The number of entries per page, if not presented in the request, should be defaulted to the maximum value of 250.

Body

networkstring · enumRequired

The network on which validators should be created. Supported values are;

mainnet
hoodi

Possible values:

startstringRequired

It specifies the start epoch if the type is 1, or the start date in the "YYYY-MM-DD" format (UTC timezone) if the type is 2

Example: 200000

endstringRequired

It specifies the end epoch if the type is 1, or the end date in the "YYYY-MM-DD" format (UTC timezone) if the type is 2

Example: 200100

rollup_typestring · enumRequired

Denotes the granularity of rewards breakdown. The applicable values are,

1 (epoch)
2 (date)

Possible values:

pubkeysstring[]Optional

List of validator public keys to fetch the rewards breakdown. A maximum of 50 entries are allowed.

Example: 0xab28a95b78913394e2a345e0e5866add7ed7e3fb7a512a7e36451a8b2b95439ccde878eaa4d31fedd6e684b04006776a

Responses

200

Sample success response payload. See Response schema below for wrapper

application/json

networkstring · enumOptional

Network specified in the request.

Possible values:

startstringOptional

Start epoch or start date specified in the request.

Example: 200000

endstringOptional

End epoch or end date specified in the request.

Example: 200100

pageinteger · int32Optional

The current page number sent in the request

Example: 1

totalinteger · int32Optional

The total number of records resulted for the input criteria.

Example: 1

400

Bad Request

application/json

500

Internal Server Error

application/json

post

/v1/ethereum/validators/withdrawals

POST /v1/ethereum/validators/withdrawals HTTP/1.1
Host: localhost
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 184

{
  "network": "mainnet",
  "start": "200000",
  "end": "200100",
  "rollup_type": "1",
  "pubkeys": [
    "0xab28a95b78913394e2a345e0e5866add7ed7e3fb7a512a7e36451a8b2b95439ccde878eaa4d31fedd6e684b04006776a"
  ]
}

{
  "network": "mainnet",
  "start": "200000",
  "end": "200100",
  "page": 1,
  "total": 1,
  "data": [
    {
      "timestamp": "2024-01-10 12:45:00",
      "slot": 653848,
      "block": 12224322,
      "epoch": 200070,
      "pubkey": "0xab28a95b78913394e2a345e0e5866add7ed7e3fb7a512a7e36451a8b2b95439ccde878eaa4d31fedd6e684b04006776a",
      "validator_index": "120",
      "withdrawal_credential_type": "0x01",
      "withdrawal_address": "0x793aA4ea0Cb9fBBF0033320C3F3795ef713a3BEe",
      "withdrawal_amount_eth": 0.1,
      "withdrawal_amount_wei": "100000000000000000",
      "is_full_withdrawal": false
    }
  ]
}

Rewards

post

The rewards endpoint returns validators accrued rewards on execution and consensus layers at epoch and daily basis. This endpoint returns rewards for validators created via provision validators endpoint as well as registered for validator monitoring. This endpoint accepts the filtering by start and end (can be epoch or date), and validator public keys.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

pagestringOptional

The current page number requested by the client, if not specified, should be defaulted to 1.

sizestringOptional

The number of entries per page, if not presented in the request, should be defaulted to the maximum value of 250.

Body

networkstring · enumRequired

The network on which validators should be created. Supported values are;

mainnet
hoodi

Possible values:

startstringRequired

It specifies the start epoch if the type is 1, or the start date in the "YYYY-MM-DD" format (UTC timezone) if the type is 2

Example: 200000

endstringRequired

It specifies the end epoch if the type is 1, or the end date in the "YYYY-MM-DD" format (UTC timezone) if the type is 2

Example: 200100

rollup_typestring · enumRequired

Denotes the granularity of rewards breakdown. The applicable values are,

1 (epoch)
2 (date)

Possible values:

pubkeysstring[]Optional

List of validator public keys to fetch the rewards breakdown. A maximum of 50 entries are allowed.

Example: 0xab28a95b78913394e2a345e0e5866add7ed7e3fb7a512a7e36451a8b2b95439ccde878eaa4d31fedd6e684b04006776a

Responses

200

Sample success response payload. See Response schema below for wrapper

application/json

networkstring · enumOptional

Network specified in the request.

Possible values:

startstringOptional

Start epoch or start date specified in the request.

Example: 200000

endstringOptional

End epoch or end date specified in the request.

Example: 200100

pageinteger · int32Optional

The current page number sent in the request

Example: 1

totalinteger · int32Optional

The total number of records resulted for the input criteria.

Example: 1

400

Bad Request

application/json

500

Internal Server Error

application/json

post

/v1/ethereum/validators/rewards

POST /v1/ethereum/validators/rewards HTTP/1.1
Host: localhost
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 184

{
  "network": "mainnet",
  "start": "200000",
  "end": "200100",
  "rollup_type": "1",
  "pubkeys": [
    "0xab28a95b78913394e2a345e0e5866add7ed7e3fb7a512a7e36451a8b2b95439ccde878eaa4d31fedd6e684b04006776a"
  ]
}

{
  "network": "mainnet",
  "start": "200000",
  "end": "200100",
  "page": 1,
  "total": 1,
  "data": [
    {
      "pubkey": "0xb794f5ea0ba39494ce839613fffba74279579268",
      "validator_index": "10000",
      "withdrawal_credential_type": "0x01",
      "total_eth": 0.1,
      "total_wei": "100000000000000000",
      "accumulated_rewards": [
        {
          "type": "EXECUTION",
          "accumulated_eth": 0.05,
          "accumulated_wei": "50000000000000000"
        }
      ],
      "rewards_breakdown": {
        "epoch": 200000,
        "balance_in_wei": "32000000000000000000",
        "balance_in_eth": 32,
        "timestamp": "2023-12-24 12:30:23",
        "rewards": {
          "type": "EXECUTION",
          "recipient": "0xed488e6cc4b030eb5bfdde3227c3d5da2b9040e8",
          "slot": 7334780,
          "block": 18146690,
          "rewards_eth": 0.05,
          "rewards_wei": "50000000000000000",
          "is_mev": true,
          "mev_relay": "Galaxy Boost",
          "mev_builder": "0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5",
          "tx_hash": "0x25e3a03462a55b2632573cfc8e36cbb431d38793b6d26603cb11fd0251fee73b"
        }
      }
    }
  ]
}

Consolidate Validators

post

The consolidate endpoint enables clients to perform the following actions:

Convert withdrawal credential type 0x01 validators to the 0x02 type.
Consolidate a type 0x01 or 0x02 validator with a type 0x02 validator by adding the balance of the former to the latter while exiting the former.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

client_req_idstringRequired

A unique identifier for the staking request generated by the client.

Example: 98bf80uy-c7ca-4082-a526-8asen545cc62

networkundefined · enumRequired

The network to which the source and destination validators belong to. Supported values are:

mainnet
hoodi

Example: hoodiPossible values:

source_pubkeysstring[] · min: 1 · max: 50Required

The type 0x01 validators to be converted to type 0x02 or type 0x01 and 0x02 validators to be merged with the destination_pubkey.

A maximum of 50 validators are supported.

Example: 0x84d7a9fc78c41f25396c8fd144c9b43d093eff03f569235728e1f9983acebf9a476c13c969d5a099c21412cdd703fbf4

destination_pubkeystringOptional

The validator that will hold the merged balance. Must be a 0x02 type validator.

Example: 0xaa01b02b16b7a56850cc9b7e1275e8d49e16fc12bd30b4bdf2ef68b5543822b2466101cb541b8815b5ca1721120e4f9d

Responses

200

OK

application/json

client_req_idstringOptional

The unique identifier specified in the request.

Example: 98bf80uy-c7ca-4082-a526-8asen545cc62

networkundefined · enumOptional

Network to which the source and destination validators belong to.

Example: hoodiPossible values:

destination_pubkeystringOptional

The validator that will hold the merged balance. If the request was a conversion, this will be kept empty.

Example: 0xaa01b02b16b7a56850cc9b7e1275e8d49e16fc12bd30b4bdf2ef68b5543822b2466101cb541b8815b5ca1721120e4f9d

consolidation_contract_addressstringOptional

Encoded function call data to be broadcasted to the Batch Deposit Contract.

Example: 0x0000BBdDc7CE488642fb579F8B00f3a590007251

created_atstring · date-timeOptional

The time at which the request was received by the platform. Time will be shown in the “YYYY-MM-DD HH:mm:ss” format.

Example: 2025-05-29 07:44:00

400

Bad Request

application/json

500

Internal Server Error

application/json

post

/v1/ethereum/validators/consolidate

POST /v1/ethereum/validators/consolidate HTTP/1.1
Host: localhost
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 316

{
  "client_req_id": "98bf80uy-c7ca-4082-a526-8asen545cc62",
  "network": "hoodi",
  "source_pubkeys": [
    "0x84d7a9fc78c41f25396c8fd144c9b43d093eff03f569235728e1f9983acebf9a476c13c969d5a099c21412cdd703fbf4"
  ],
  "destination_pubkey": "0xaa01b02b16b7a56850cc9b7e1275e8d49e16fc12bd30b4bdf2ef68b5543822b2466101cb541b8815b5ca1721120e4f9d"
}

{
  "client_req_id": "98bf80uy-c7ca-4082-a526-8asen545cc62",
  "network": "hoodi",
  "destination_pubkey": "0xaa01b02b16b7a56850cc9b7e1275e8d49e16fc12bd30b4bdf2ef68b5543822b2466101cb541b8815b5ca1721120e4f9d",
  "consolidation_contract_address": "0x0000BBdDc7CE488642fb579F8B00f3a590007251",
  "data": [
    {
      "source_pubkey": "0xa82eb9e806a4706852b5373c0597690249e6ae6047a08339749e534f6e51d750a1b065204712cbf71d4fa04e78a86604",
      "contract_call_data": "0xa82eb9e806a4706852b5373c0597690249e6ae6047a08339749e534f6e51d750a1b065204712cbf71d4fa04e78a86604aa01b02b16b7a56850cc9b7e1275e8d49e16fc12bd30b4bdf2ef68b5543822b2466101cb541b8815b5ca1721120e4f9d",
      "signer": [
        "0x4473dcddbf77679a643bdb654dbd86d67f8d32f2"
      ]
    }
  ],
  "created_at": "2025-05-29 07:44:00"
}

Exit Validators via the Execution Layer

post

The execution-layer triggerable exit endpoint enables clients to initiate validator exits directly via the validator’s withdrawal address. This functionality is applicable to both withdrawal credential type 0x01 and 0x02 validators.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

client_req_idstringRequired

A unique identifier for the execution layer triggerable exit request provided by the client.

Example: 09ff80uy-c7ca-8765-a526-8shdyd45cc62

networkundefined · enumRequired

Network to which the validators belongs to. Supported values are:

mainnet
hoodi

Possible values:

typeundefined · enumRequired

Indicates the type of attribute used to identify the validators to exit. The possible values are:

1 (pubkey)
2 (validator_index)

Possible values:

pubkeysstring[] · min: 1 · max: 100Optional

List of validator public keys to be exited.

This is required if the exit type is 1.

A maximum of 100 public keys can be specified.

Example: 0x904144048d9845d83adac25e94d63f8ccd4a04e71f0c4440ce5b08d30e0851ddb209f2cca32a987d953d4901b409f8b4

validator_indexesinteger · int32[] · min: 1 · max: 100Optional

List of validator indexes to be exited.

This is required if the exit type is 2.

A maximum of 100 validator indexes can be specified.

Example: 1142745

Responses

200

OK

application/json

client_req_idstringOptional

The unique identifier specified in the request.

Example: 09ff80uy-c7ca-8765-a526-8shdyd45cc62

networkundefined · enumOptional

Network to which the validators belong to.

Example: hoodiPossible values:

exit_contract_addressstringOptional

Encoded function call data to be broadcasted to the Batch Deposit Contract.

Example: 0x00000961Ef480Eb55e80D19ad83579A64c007002

created_atstring · date-timeOptional

The time at which the request was received by the platform. Time will be shown in the “YYYY-MM-DD HH:mm:ss” format.

Example: 2025-05-30 06:53:28

400

Bad Request

application/json

500

Internal Server Error

application/json

post

/v1/ethereum/validators/el-triggerable-exit

POST /v1/ethereum/validators/el-triggerable-exit HTTP/1.1
Host: localhost
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 228

{
  "client_req_id": "09ff80uy-c7ca-8765-a526-8shdyd45cc62",
  "network": "mainnet",
  "type": 1,
  "pubkeys": [
    "0x904144048d9845d83adac25e94d63f8ccd4a04e71f0c4440ce5b08d30e0851ddb209f2cca32a987d953d4901b409f8b4"
  ],
  "validator_indexes": [
    1142745
  ]
}

{
  "client_req_id": "09ff80uy-c7ca-8765-a526-8shdyd45cc62",
  "network": "hoodi",
  "exit_contract_address": "0x00000961Ef480Eb55e80D19ad83579A64c007002",
  "data": [
    {
      "pubkey": "0x904144048d9845d83adac25e94d63f8ccd4a04e71f0c4440ce5b08d30e0851ddb209f2cca32a987d953d4901b409f8b4",
      "validator_index": 1142745,
      "contract_call_data": "0x904144048d9845d83adac25e94d63f8ccd4a04e71f0c4440ce5b08d30e0851ddb209f2cca32a987d953d4901b409f8b40000000000000000",
      "signer": [
        "0xbfb113c348168e2691c2a13f6a2cd6cb27329330"
      ]
    }
  ],
  "created_at": "2025-05-30 06:53:28"
}

Partially Withdraw Validator Balances via the Execution Layer

post

For validators with withdrawal credential type 0x01, any balance in excess of 32 ETH is automatically swept to the validator’s withdrawal address by the protocol. In contrast, 0x02 validators do not support automatic sweeping. Instead, clients can initiate partial withdrawals via the API.

The partial withdrawal amount is computed as the lesser of:

the user-specified withdrawal amount, and
(current balance − 32 ETH − pending withdrawals)

This ensures that the maximum amount that can be withdrawn from a 0x02 validator is limited to the validator's effective balance in excess of 32 ETH, excluding any amounts already pending withdrawal.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

client_req_idstringRequired

A unique identifier for the execution layer triggerable withdrawal request provided by the client.

Example: 09ff80uy-c7ca-8765-a526-8shdyd45cc62

networkundefined · enumRequired

Network to which the validators belongs to. Supported values are:

mainnet
hoodi

Possible values:

typeundefined · enumRequired

Indicates the type of attribute used to identify the validators that need partial withdrawals. The possible values are:

1 (pubkey)
2 (validator_index)

Possible values:

Responses

200

OK

application/json

client_req_idstringOptional

The unique identifier specified in the request.

Example: 09ff80uy-c7ca-8765-a526-8shdyd45cc62

networkundefined · enumOptional

Network to which the validators belong to.

Example: hoodiPossible values:

withdrawal_contract_addressstringOptional

Encoded function call data to be broadcasted to the Batch Deposit Contract.

Example: 0x00000961Ef480Eb55e80D19ad83579A64c007002

created_atstring · date-timeOptional

The time at which the request was received by the platform. Time will be shown in the “YYYY-MM-DD HH:mm:ss” format.

Example: 2025-05-30 06:53:28

400

Bad Request

application/json

500

Internal Server Error

application/json

post

/v1/ethereum/validators/el-triggerable-withdrawal

POST /v1/ethereum/validators/el-triggerable-withdrawal HTTP/1.1
Host: localhost
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 243

{
  "client_req_id": "09ff80uy-c7ca-8765-a526-8shdyd45cc62",
  "network": "mainnet",
  "type": 1,
  "data": [
    {
      "pubkey": "0x97c107c786c56ffbe5d41f3f155e8a5c1a69239e3a1f881564b68015b0a3485fef7c80952155f7c1ba8d2b209e263577",
      "validator_index": 1091601,
      "amount": 1
    }
  ]
}

{
  "client_req_id": "09ff80uy-c7ca-8765-a526-8shdyd45cc62",
  "network": "hoodi",
  "withdrawal_contract_address": "0x00000961Ef480Eb55e80D19ad83579A64c007002",
  "data": [
    {
      "pubkey": "0x904144048d9845d83adac25e94d63f8ccd4a04e71f0c4440ce5b08d30e0851ddb209f2cca32a987d953d4901b409f8b4",
      "validator_index": 1142745,
      "amount": 1,
      "contract_call_data": "0x904144048d9845d83adac25e94d63f8ccd4a04e71f0c4440ce5b08d30e0851ddb209f2cca32a987d953d4901b409f8b40000000000000000",
      "signer": [
        "0xbfb113c348168e2691c2a13f6a2cd6cb27329330"
      ]
    }
  ],
  "created_at": "2025-05-30 06:53:28"
}

Top Up Validators

post

The top-up endpoint allows staking partners to add additional ETH to existing validators with withdrawal credential type 0x01 or 0x02. At this point Galaxy does not support batch top ups.

0x01 validators: The valid top up amount must be between 1 ETH and the amount required to reach a total balance of 32 ETH.
0x02 validators: The valid top up amount must be between 1 ETH and the amount required to reach a total balance of 2048 ETH.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

client_req_idstringRequired

A unique identifier for the execution layer triggerable withdrawal request provided by the client.

Example: 19oky65uy-c7ca-8765-a526-8svsgd45cj09

networkundefined · enumRequired

Network to which the validators belongs to. Supported values are:

mainnet
hoodi

Example: hoodiPossible values:

Responses

200

OK

application/json

client_req_idstringOptional

The unique identifier specified in the request.

Example: 19oky65uy-c7ca-8765-a526-8svsgd45cj09

networkstring · enumOptional

Network to which the validators belong to.

Example: hoodiPossible values:

400

Bad Request

application/json

500

Internal Server Error

application/json

post

/v1/ethereum/validators/topup

POST /v1/ethereum/validators/topup HTTP/1.1
Host: localhost
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 216

{
  "client_req_id": "19oky65uy-c7ca-8765-a526-8svsgd45cj09",
  "network": "hoodi",
  "data": [
    {
      "pubkey": "0xa42a5d150a1ab2846f2e49a539472b436274cbc4a459b042c764c623a70a2ab892344565c066d6b101ad97ab9e701ce0",
      "deposit_amount": 32
    }
  ]
}

{
  "client_req_id": "19oky65uy-c7ca-8765-a526-8svsgd45cj09",
  "network": "hoodi",
  "data": [
    {
      "batch_id": 1,
      "deposit_data": [
        {
          "pubkey": "0xa42a5d150a1ab2846f2e49a539472b436274cbc4a459b042c764c623a70a2ab892344565c066d6b101ad97ab9e701ce0",
          "amount": 32000000000,
          "withdrawal_credentials": "01000000000000000000000032be343b94f860124dc4fee278fdcbd38c102d88",
          "signature": "a5f135bb1f7df7c0a9d4d3af20831838acf0de84d89cbcb54ce384944f6edc46b47fe5ba246776ba52566cfead06866805de8b1e098985eb87ffd19728d1d655cdfe4120e48ba33e69a86aeb1d9a26cae34235ea745e5fe854a6ffeee8012812",
          "deposit_data_root": "a23718c6e2b3db82d1d51329b57b59b3a85889c5b0684de88180c3e89c5bf00e",
          "deposit_message_root": "0032195f91e6ba22d10b93973787783b797b59431cbb5fe0056a1255e9d2b7b8",
          "fork_version": "10000910",
          "deposit_cli_version": "2.7.0"
        }
      ],
      "deposit_transaction": [
        {
          "deposit_amount_wei": "32000000000000000000",
          "deposit_address": "0xc8b600A20d10f513bf7E879058EFDEeB7E646b0b",
          "contract_call_data": "0x4f498c730000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000001a00000000000000000000000000000000000000000000000000000000000000260000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000030a42a5d150a1ab2846f2e49a539472b436274cbc4a459b042c764c623a70a2ab892344565c066d6b101ad97ab9e701ce00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002001000000000000000000000032be343b94f860124dc4fee278fdcbd38c102d88000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000060a5f135bb1f7df7c0a9d4d3af20831838acf0de84d89cbcb54ce384944f6edc46b47fe5ba246776ba52566cfead06866805de8b1e098985eb87ffd19728d1d655cdfe4120e48ba33e69a86aeb1d9a26cae34235ea745e5fe854a6ffeee80128120000000000000000000000000000000000000000000000000000000000000001a23718c6e2b3db82d1d51329b57b59b3a85889c5b0684de88180c3e89c5bf00e"
        }
      ]
    }
  ]
}

Get Fees

post

The get fees endpoint allows clients to retrieve the current fee applicable to the following actions on existing validators:

Consolidation or conversion
Execution-layer triggerable exits or partial withdrawals

Fees are dynamic and vary based on the number of pending requests in the corresponding processing queue. It is recommended to call this endpoint before submitting a request to ensure awareness of the applicable fee.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

networkundefined · enumRequired

Network to which the validators belongs to. Supported values are:

mainnet
hoodi

Example: hoodiPossible values:

operation_typeundefined · enumRequired

Indicates the type of operation for which the user is requesting fees.

1 (validator_consolidation_or_conversion)
2 (el_triggerable_exit_or_withdrawal)

Example: 1Possible values:

Responses

200

OK

application/json

networkundefined · enumOptional

Network to which the validators belong to.

Example: hoodiPossible values:

operation_typeundefined · enumOptional

Indicates the type of operation for which the user is requesting fees.

validator_consolidation_or_conversion
el_triggerable_exit_or_withdrawal

Example: validator_consolidation_or_conversionPossible values:

fee_in_ETHnumber · floatOptional

The applicable fee in ETH.

Example: 1e-18

fee_in_WEIstringOptional

The applicable fee in WEI.

Example: 1

retrieved_atstringOptional

The time at which the fee was retrieved by the platform. Time will be shown in the “YYYY-MM-DD HH:mm:ss” format.

Example: 2025-05-29 08:00:35

400

Bad Request

application/json

500

Internal Server Error

application/json

post

/v1/ethereum/validators/fee

POST /v1/ethereum/validators/fee HTTP/1.1
Host: localhost
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "network": "hoodi",
  "operation_type": 1
}

{
  "network": "hoodi",
  "operation_type": "validator_consolidation_or_conversion",
  "fee_in_ETH": 1e-18,
  "fee_in_WEI": "1",
  "retrieved_at": "2025-05-29 08:00:35"
}

Get Deposit Data

get

The deposit data endpoint facilitates the retrieval of the Provision Validators endpoint’s response, which contains the deposit data, using the Client Request ID of the original request.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

client_req_idstringOptional

The Client Request ID applicable to the Provision Validators request for which deposit data is required.

Responses

200

OK

application/json

client_req_idstringOptional

The client_req_id of the original Provision Validators request for which the response is returned.

Example: 49bf80cb-c7ca-4082-a526-8afab545cc62

staking_ref_idstringOptional

A unique reference ID generated by the staking infrastructure for the staking request.

Example: 59bf80cb-c7ca-4082-a526-8afab545cc62

networkstring · enumOptional

The network on which validators should be created. Supported values are;

mainnet
hoodi

Example: mainnetPossible values:

withdrawal_credentials_typeundefined · enumOptional

The withdrawal credential type of the validator(s) that will be created. Applicable values are;

0x01
0x02

Example: 0x02Possible values:

withdrawal_addressstringOptional

The specified address to which funds will be withdrawn, as mentioned in the staking request.

Example: 0x1D1479C185d32EB90533a08b36B3CFa5F84A0E6B

fee_recipient_addressstringOptional

The fee recipient address that receives Execution Layer fees, as mentioned in the staking request.

Example: 0x1D1479C185d32EB90533a08b36B3CFa5F84A0E6B

regionstring · enumOptional

The geographic region where the validator will be created. Supported values are;

US
EU
KR

Example: USPossible values:

provisioned_atstring · date-timeOptional

The date and time when the validator was provisioned by the staking infrastructure.

Example: 2025-05-04 10:25:24

400

Bad Request

application/json

500

Internal Server Error

application/json

get

/v1/ethereum/validators/deposit-data

GET /v1/ethereum/validators/deposit-data HTTP/1.1
Host: localhost
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "client_req_id": "49bf80cb-c7ca-4082-a526-8afab545cc62",
  "staking_ref_id": "59bf80cb-c7ca-4082-a526-8afab545cc62",
  "network": "mainnet",
  "withdrawal_credentials_type": "0x02",
  "withdrawal_address": "0x1D1479C185d32EB90533a08b36B3CFa5F84A0E6B",
  "fee_recipient_address": "0x1D1479C185d32EB90533a08b36B3CFa5F84A0E6B",
  "region": "US",
  "provisioned_at": "2025-05-04 10:25:24",
  "data": [
    {
      "batch_id": 1,
      "deposit_data": [
        {
          "pubkey": "0xb5d1110cb4e7cda0d4f3390b29e7bc7e07bb63490eeb78782d70997991c7d9901befa9dd8955f2bd574aa0bd524fbc14",
          "amount": 40000000000,
          "withdrawal_credentials": "02000000000000000000000000x1D1479C185d32EB90533a08b36B3CFa5F84A0E6B",
          "signature": "ad7e6e09743d9912bb3639d00d43b367420f60a65607b7092d36a0312963ecfa866a2b3b90a1b20183b7ef6c9b5c4e3608dc684080e1b7f9fbc6f71c3dd30c711eb63a68d5cb12c5007dd3b2cc0106cc2c7c96bc79acf5ee119c9f16288fda47",
          "deposit_data_root": "940f83319b35eb39475bf4e963d540da685a389bb5b05cafa52f47fb462c2844",
          "deposit_message_root": "88c4d10991623845ef99fec1796cb04b406652d12c3918f7f27089d1331e2007",
          "fork_version": "10000910",
          "deposit_cli_version": "2.7.0"
        }
      ],
      "deposit_transaction": {
        "deposit_amount_wei": "40000000000000000000",
        "deposit_address": "0xc8b600A20d10f513bf7E879058EFDEeB7E646b0b",
        "contract_call_data": "0x4f498c7300000......"
      }
    }
  ]
}

Update Fee Recipient Address

post

The update fee recipient address endpoint allows clients to update their validators’ fee recipient address and direct execution-layer rewards to a new wallet.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

client_req_idstringRequired

A unique identifier for the request provided by the client.

Example: 09kkk80uy-c7ca-8765-a526-8shdyd45cj85

networkstringRequired

Network to which the validators belong to.

Possible values:

mainnet
hoodi

Example: mainnet

typeintegerRequired

Indicates the type of attribute used to identify the validators that need address changes. The possible values are,

1 (pubkeys)

2 (validator_index)

Example: 1

Responses

200

OK

application/json

client_req_idstringOptional

The unique identifier specified in the request.

Example: 09kkk80uy-c7ca-8765-a526-8shdyd45cj85

networkstringOptional

Network to which the validators belong to.

Example: mainnet

400

Bad Request

application/json

500

Internal Server Error

application/json

post

/v1/ethereum/validators/update-fee-recipient

POST /v1/ethereum/validators/update-fee-recipient HTTP/1.1
Host: localhost
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 302

{
  "client_req_id": "09kkk80uy-c7ca-8765-a526-8shdyd45cj85",
  "network": "mainnet",
  "type": 1,
  "data": [
    {
      "pubkey": "0xa5a4efa5efe267fe1dc611fdb6e717b2dc42f58846812459c0f03f144f8716cb3d6c4ec65c3a42eedf1f5c53d2205795",
      "validator_index": 1147684,
      "fee_recipient_address": "0x0ec184866E52FA69387B50f9Cf5e75Ba7605DA78"
    }
  ]
}

{
  "client_req_id": "09kkk80uy-c7ca-8765-a526-8shdyd45cj85",
  "network": "mainnet",
  "data": [
    {
      "pubkey": "0xa5a4efa5efe267fe1dc611fdb6e717b2dc42f58846812459c0f03f144f8716cb3d6c4ec65c3a42eedf1f5c53d2205795",
      "validator_index": 1147684,
      "fee_recipient_address": "0x0ec184866E52FA69387B50f9Cf5e75Ba7605DA78"
    }
  ]
}

hashtagProvision Validators

hashtagExit Validators

hashtagDerive Pre-Signed Exit Message

hashtagGet All Validators or by Staking Reference ID

hashtagGet a Single Validator

hashtagGet Validators Summary

hashtagWithdrawals

hashtagRewards

hashtagConsolidate Validators

hashtagExit Validators via the Execution Layer

hashtagPartially Withdraw Validator Balances via the Execution Layer

hashtagTop Up Validators

hashtagGet Fees

hashtagGet Deposit Data

hashtagUpdate Fee Recipient Address

Provision Validators

Exit Validators

Derive Pre-Signed Exit Message

Get All Validators or by Staking Reference ID

Get a Single Validator

Get Validators Summary

Withdrawals

Rewards

Consolidate Validators

Exit Validators via the Execution Layer

Partially Withdraw Validator Balances via the Execution Layer

Top Up Validators

Get Fees

Get Deposit Data

Update Fee Recipient Address