latestOpenAPI 3.0.02026-08-138371125.7 KB

707a88e0b355

Cluster Lock

Retrieve a list of Distributed Validator Cluster Lock Objects

This endpoint is used to search for Cluster Lock Objects that match a substring of their lock_hash.

get/v1/lock/search/{network}

Path parameters

networkstring required

The network to retrieve clusters on

Query parameters

partialLockHashstring required

A substring of the lock_hash calculated for a cluster lock.

partialClusterNamestring required

A substring of the cluster name.

pageinteger required

The page number to retrieve.

limitinteger required

The number of cluster lock objects to return.

Response

A list of Distributed Validator Clusters which the lock hash matches.

cluster_locksstring[] required
total_active_stake_ethnumber nullable

Null when the operator has locks but no recent metrics snapshot is available.

total_active_stake_usdnumber nullable

Null when the operator has locks but no recent metrics snapshot is available.

unique_validators_countnumber nullable

Null when the operator has locks but no recent metrics snapshot is available.

total_countnumber required
total_pagesnumber required

Example response

{
  "total_active_stake_eth": 128.5,
  "total_active_stake_usd": 128.5,
  "unique_validators_count": 10,
  "total_count": 2,
  "total_pages": 4
}