Everstake Ethereum B2B APIRetrieve Validators for a Specific Staking Position
[GET]/positions/{position_id}/validators
| Endpoint | Description |
|---|---|
| eth-api.everstake.one/api/v1/eth2_staking/positions/{position_id}/validators | Provides a list of validators associated with a specific staking position. |
Request Parameters
| Parameter | Type | Description |
|---|---|---|
position_id* | string | The unique identifier of the staking position. |
include | string | Set this to "position" to include position data in the response. |
status_history | boolean | If included, status change history will be provided for each validator. |
status | string | To filter validators by status. Accepts values like: funding_requested, deposited, pending_initialized, pending_queued, active_ongoing, active_exiting, active_slashed, exited_unslashed, exited_slashed, withdrawal_possible, withdrawal_done, provisioned. |
page[size] | integer | The number of results per page for pagination. |
page[number] | integer | The specific page to display. |
Request Example
plaintext
https://eth-api.everstake.one/api/v1/eth2_staking/positions/1/validators?
page%5Bsize%5D=20&page%5Bnumber%5D=1
Request cURL
bash
curl -X 'GET' \
'https://eth-api.everstake.one/api/v1/eth2_staking/positions/1/validators?
page%5Bsize%5D=20&page%5Bnumber%5D=1' \
-H 'accept: application/json'
Response Details
| Parameter | Type | Description |
|---|---|---|
data:id | integer | Unique identifier of the validator. |
data:type | string | The type of object, which is "validator" for this endpoint. |
data:attributes | object | Contains attributes of the validator including unique ID, public key, amount, position name, status, etc. |
data:relationships:position:data | object | Contains information about the associated staking position. |
links | object | Contains pagination links based on page[size] and page[number]. Includes self, current, next, last, and prev. |
included | array | Contains detailed information of the included object. The object includes a unique identifier, type, name, Ethereum withdrawal address, staked amount, number of validators, creation and update timestamp. |
Response Example
json
{
"data": [
{
"id": "31",
"type": "validator",
"attributes": {
"id": 31,
"pubkey": "d1ef8d468ef53d82368d2026e321ab2c6d44f44c33b7b9f22369bf6dcf37fb0208f82dd6b485325ce1bbf5aec7ad45bb",
"name": "string",
"withdrawal_credentials": "010000000000000000000000fc438e6cc4b230eb5bfaae1337c3f5da2b9140f1",
"amount": 32000000000,
"signature": "aab7e3b41689fced6c3437a6bc5caf471ed319b94ad2642c47c5f641d5e3a046432171d47d48cd7a3e8a323939d4976c1315ad4dae134c421214673ddff9105ef1bb7f79c1babc6cd9c31428d5e44472164e9c9fccfd10fb9768c0855b194f49",
"deposit_data_root": "b2f5083221d6b61f2237af155c07c746f6a75c7d24dfe418106efdf87e9b9422",
"deposit_message_root": "026cbefa013e03a3d81592b7a5f6205773c12a6f7674529e497e9a4eb2df2d44",
"deposit_cli_version": "1.2.0",
"fork_version": "00000000",
"eth2_network_name": "goerli",
"status": "funding_requested",
"status_synced_at": "2023-01-14T16:00:14.459Z",
"fee_recipient_address": "0x781462762B706AA7c1DA71FBA1a545724928b81f"
},
"status_history": [
{
"status": "funding_requested",
"changed_at": "2023-01-14T16:00:14.459Z"
}
],
"relationships": {
"position": {
"data": {
"id": "13",
"type": "position"
}
}
}
}
],
"links": {
"self": "string",
"current": "string"
},
"included": [
{
"id": "77",
"type": "position",
"attributes": {
"id": 77,
"eth1_withdrawal_address": "0xE40F80618324C814cD444434670a44ba4583aE38",
"staked_amount": 128,
"validators_count": 4,
"created_at": "2022-03-21T13:30:54.214Z",
"updated_at": "2022-10-17T14:40:10.618Z",
"name": null
}
}
]
}