OBobol
Cluster Lock

Get average peer scores for operators in a cluster

Changed on

Returns average peer_score (and nicknames) for operators in a cluster, sorted by peer_score descending.

get/v1/lock/{lockHash}/peer-scores

Request

  • Base URL
    https://api.obol.tech
  • Auth
    none declared

Path parameters

lockHashstring required

The lock_hash calculated for a cluster lock.

Query parameters

startDatestring
Example:2026-01-21T00:00:00.000Z

Start date for the range (ISO 8601 format). If not provided, defaults to endDate - 7 days.

endDatestring
Example:2026-01-28T00:00:00.000Z

End date for the range (ISO 8601 format). If not provided, defaults to the latest available date.

Response

Array of operator addresses with their average peer scores

operator_addressstring
avg_peer_scorenumber
peer_namestring nullable

Peer name shown when the peer score row has no operator address.

peer_nicknamestring nullable

Operator-configured peer nickname, when available.

last_updatedstring date-time

Latest peer_score date included in this averaged rank row.

Example response

[
  {
    "operator_address": "0x7a82E643B0c8AE619f71d9667559180c33c92277",
    "avg_peer_score": 99.89,
    "peer_name": "puzzled-pen",
    "peer_nickname": "Alice node",
    "last_updated": "2026-02-10T00:00:00.000Z"
  }
]

Changes

  • c545dd14c211Revision changes
    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

  • 707a88e0b355Revision changes
    • warning

      deleted the query request parameter includeOperatorStubs

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status