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/v1/rocketpool/validator/{indexOrPubkey}

Get Rocket Pool validator metadata by index or pubkey

cURL

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

200

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

ApiKeyAuthQueryApiKeyAuthHeader

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

200

application/json

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