Get Rocket Pool validator metadata by index or pubkey

curl --request GET \
  --url 'https://beaconcha.in/api/v1/rocketpool/validator/{indexOrPubkey}?apikey='

{
  "status": "OK",
  "data": {
    "claimed_smoothing_pool": 2558507058679352300,
    "effective_rpl_stake": 0,
    "index": 652648,
    "is_vacant": false,
    "minipool_address": "0xc20eb9eca73be78a523aad5a4d9b70c797ff58a1",
    "minipool_deposit_type": "Variable",
    "minipool_node_fee": 0.14,
    "minipool_status": "Staking",
    "minipool_status_time": 1684570331,
    "node_address": "0xfff1f570f09c073b6621c032b6072847fe9d6fac",
    "node_deposit_balance": 8000000000000000000,
    "node_deposit_credit": 0,
    "node_max_rpl_stake": 0,
    "node_min_rpl_stake": 0,
    "node_refund_balance": 0,
    "node_rpl_stake": 0,
    "node_timezone_location": "Etc/UTC",
    "penalty_count": 0,
    "rpl_cumulative_rewards": 487854676781293300000,
    "smoothing_pool_opted_in": false,
    "unclaimed_rpl_rewards": 0,
    "unclaimed_smoothing_pool": 0,
    "user_deposit_balance": 24000000000000000000,
    "version": 3
  }
}

Rocketpool

Get Rocket Pool validator metadata by index or pubkey

Retrieve Rocket Pool–specific metadata for one or more Ethereum consensus validators.

You provide a comma-separated list of validator identifiers in the path parameter. The server resolves each identifier to a validator index and returns the corresponding Rocket Pool minipool and node data.

Response shape:

If you request a single validator, the response data field is a single object.
If you request multiple validators, the data field is an array of objects in no guaranteed order.

Use this endpoint to answer questions such as:

What is the current minipool status and node fee for a validator?
Has the node opted into the smoothing pool, and how much has been claimed or remains unclaimed?
What are the node’s RPL stake metrics (effective, min, max)?

GET

api

rocketpool

validator

{indexOrPubkey}

Get Rocket Pool validator metadata by index or pubkey

curl --request GET \
  --url 'https://beaconcha.in/api/v1/rocketpool/validator/{indexOrPubkey}?apikey='

{
  "status": "OK",
  "data": {
    "claimed_smoothing_pool": 2558507058679352300,
    "effective_rpl_stake": 0,
    "index": 652648,
    "is_vacant": false,
    "minipool_address": "0xc20eb9eca73be78a523aad5a4d9b70c797ff58a1",
    "minipool_deposit_type": "Variable",
    "minipool_node_fee": 0.14,
    "minipool_status": "Staking",
    "minipool_status_time": 1684570331,
    "node_address": "0xfff1f570f09c073b6621c032b6072847fe9d6fac",
    "node_deposit_balance": 8000000000000000000,
    "node_deposit_credit": 0,
    "node_max_rpl_stake": 0,
    "node_min_rpl_stake": 0,
    "node_refund_balance": 0,
    "node_rpl_stake": 0,
    "node_timezone_location": "Etc/UTC",
    "penalty_count": 0,
    "rpl_cumulative_rewards": 487854676781293300000,
    "smoothing_pool_opted_in": false,
    "unclaimed_rpl_rewards": 0,
    "unclaimed_smoothing_pool": 0,
    "user_deposit_balance": 24000000000000000000,
    "version": 3
  }
}

Authorizations

apikey

string

query

required

Path Parameters

indexOrPubkey

string

required

Comma-separated list (no spaces) of validator identifiers to query. Each identifier may be either:

A validator index as a base-10 integer (for example, 652648)
A BLS public key as a 96-hex-character string with or without the 0x prefix (case-insensitive)

Limits and resolution behavior:

You can pass up to a server-enforced per-request limit. The default limit is 100.
Public keys that cannot be resolved to an existing validator index cause the request to fail with HTTP 400.
Duplicate identifiers are de-duplicated internally.

Comma-separated list (no spaces) of validator identifiers. Each identifier must be either:

A validator index as a base-10 integer (for example, 652648)
A BLS public key as a 96-hex-character string with or without the 0x prefix (case-insensitive)

Resolution and limits:

The server resolves public keys to validator indices before querying data.
The total number of identifiers must not exceed the server-enforced limit (default 100).
Identifiers that cannot be parsed or resolved result in HTTP 400.

Example:

"1,2,3"

Response

Successful response with Rocket Pool validator data.

Standard success envelope used by all API endpoints.

status

enum<string>

HTTP-independent status of the API operation. For successful responses this is always "OK".

Available options:

OK

data

object

Response payload specific to the endpoint.

Show child attributes

data.claimed_smoothing_pool

integer

Total ETH from the smoothing pool that the node has already claimed across all intervals, in wei.

Example:

2558507058679352300

data.effective_rpl_stake

number

Effective RPL stake for the node after applying protocol caps, expressed in RPL tokens.

Example:

0

data.index

integer

Consensus validator index that this entry refers to.

Example:

652648

data.is_vacant

boolean

Indicates that the minipool currently has no active validator assigned (vacant).

Example:

false

data.minipool_address

string

Ethereum address of the Rocket Pool minipool contract associated with the validator.

Example:

"0xc20eb9eca73be78a523aad5a4d9b70c797ff58a1"

data.minipool_deposit_type

string

Minipool deposit configuration. One of "Full", "Half", or "Variable".

Example:

"Variable"

data.minipool_node_fee

number

Node commission rate for this minipool as a decimal fraction in the range [0, 1]. For example, 0.14 means 14%.

Example:

0.14

data.minipool_status

string

Current on-chain minipool status. Possible values include "Initialized", "Prelaunch", "Staking", "Withdrawable", and "Dissolved".

Example:

"Staking"

data.minipool_status_time

integer

Unix timestamp (seconds) when the minipool entered the current status.

Example:

1684570331

data.node_address

string

Ethereum address of the Rocket Pool node operator that owns the minipool.

Example:

"0xfff1f570f09c073b6621c032b6072847fe9d6fac"

data.node_deposit_balance

integer

Amount of ETH contributed by the node to the minipool deposit, in wei.

Example:

8000000000000000000

data.node_deposit_credit

number

Node’s available ETH deposit credit used to form or expand minipools, in wei.

Example:

0

data.node_max_rpl_stake

number

Maximum RPL stake permitted for the node under protocol rules, in RPL tokens.

Example:

0

data.node_min_rpl_stake

number

Minimum required RPL stake for the node to remain compliant, in RPL tokens.

Example:

0

data.node_refund_balance

integer

ETH refundable to the node from the minipool, in wei.

Example:

0

data.node_rpl_stake

number

Current RPL stake held by the node, in RPL tokens.

Example:

0

data.node_timezone_location

string

IANA time zone identifier configured for the node (for example, "Etc/UTC").

Example:

"Etc/UTC"

data.penalty_count

integer

Number of penalties that have been recorded for this minipool.

Example:

0

data.rpl_cumulative_rewards

integer

Total RPL token rewards the node has already claimed across all intervals, in base units (10^18).

Example:

487854676781293300000

data.smoothing_pool_opted_in

boolean

Indicates whether the node is registered to receive smoothing pool distributions.

Example:

false

data.unclaimed_rpl_rewards

integer

RPL token rewards accrued by the node that have not yet been claimed, in base units (10^18).

Example:

0

data.unclaimed_smoothing_pool

integer

ETH from the smoothing pool that is currently unclaimed by the node, in wei.

Example:

0

data.user_deposit_balance

integer

Amount of ETH contributed by rETH users to the minipool deposit, in wei.

Example:

24000000000000000000

data.version

integer

Minipool contract version.

Example:

3

Rocket Pool network statistics

ETH.Store daily aggregates

Introduction

API Docs

Get Rocket Pool validator metadata by index or pubkey

Authorizations

Path Parameters

Response