Sign in
Cluster Lock

Get average peer scores for operators in a cluster

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

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

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

Changed in 2 of the 4 revisions of this API.133

  • 707a88e0b3553See the full diff
    • ●

      deleted the query request parameter includeOperatorStubs

      request-parameter-removed

    • ●

      removed the optional property items/avg_effectiveness from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property items/effectiveness_percentile from the response with the 200 status

      response-optional-property-removed

  • 1fe58b98e30713See the full diff
    • ▲

      the response property items/avg_peer_score became nullable for the status 200

      response-property-became-nullable

    • ○

      added the new optional query request parameter includeOperatorStubs

      new-optional-request-parameter

    • ○

      added the optional property items/avg_effectiveness to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property items/effectiveness_percentile to the response with the 200 status

      response-optional-property-added