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

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

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

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

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": [
    {
      "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

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",
  "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

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,

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

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,

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

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,
        "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

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

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

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

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)

Possible values:

Responses

200

OK

application/json

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

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

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"
    }
  ]
}