Everstake Ethereum B2B APIInitialize New Validator with Provided Attributes
[POST]/provision
| Endpoint | Description |
|---|---|
| https://eth-api.everstake.one/api/v1/eth2_staking/provision | Method which gives an opportunity to initialize a new validator with provided attributes. |
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
withdrawal_address | string | Yes | Ethereum address for withdrawal. |
validators_count | integer | Yes | Quantity of validators to be established. |
eth2_network_name | string | Yes | Name of the network, specifying either the testnet (goerli) or mainnet (mainnet). |
external_user_id | string | No | Unique identifier of the customer. |
external_user_email | string | No | Unique identifier of the customer. |
Request Example
json
{
"external_user_id": "afe3c9ca-eb3f-4291-bf00-7020abec0edf",
"external_user_email": "[email protected]",
"withdrawal_address": "0x3F124C700fb5E741F128e28985267D44f56B242F",
"validators_count": 10,
"eth2_network_name": "mainnet"
}
Request cURL
plaintext
curl -X 'POST' \
'https://eth-api.everstake.one/api/v1/eth2_staking/provision' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"external_user_id": "afe3c9ca-eb3f-4291-bf00-7020abec0edf",
"external_user_email": "[email protected]",
"withdrawal_address": "0x3F124C700fb5E741F128e28985267D44f56B242F",
"validators_count": 10,
"eth2_network_name": "mainnet"
}'
Response Details
| Parameter | Type | Description |
|---|---|---|
staked_eth_amount | integer | The total staked ETH amount. |
eth1_withdrawal_address | string | Ethereum address for withdrawal. |
eth2_network_name | string | Indicates whether the network is a testnet (Goerli) or mainnet (mainnet). |
success | boolean | A boolean indicating successful completion. The response codes can be either 200 or 201. |
Response Example
json
{
"staked_eth_amount": 32,
"eth1_withdrawal_address": "0xE40F80618324C814cD444434670a44ba4583aE38",
"eth2_network_name": "goerli",
"success": true
}