---
title: "Get average peer scores for operators in a cluster"
method: GET
path: "/v1/lock/{lockHash}/peer-scores"
tags: ["Cluster Lock"]
---

# Get average peer scores for operators in a cluster

`GET /v1/lock/{lockHash}/peer-scores`

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

## Path parameters

- `lockHash` string, required

## Query parameters

- `startDate` string
- `endDate` string

## Response `200`

Array of operator addresses with their average peer scores

- object[]
  - `operator_address` string
  - `avg_peer_score` number
  - `peer_name` string, nullable — Peer name shown when the peer score row has no operator address.
  - `peer_nickname` string, nullable — Operator-configured peer nickname, when available.
  - `last_updated` string, date-time — Latest peer_score date included in this averaged rank row.

## Other responses

- `400` — Network error - unable to determine network from fork_version Invalid date format
- `404` — Cluster lock not found
- `500` — An unknown error occurred

---

[API](https://skmtc.net/obol/apis/obol-api.md) · [All operations](https://skmtc.net/obol/apis/obol-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/obol/obol-api/revisions/707a88e0b355/schema)