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

## Changes

- **2026-08-13** `707a88e0b355` — 3 warning
  - deleted the `query` request parameter `includeOperatorStubs`
  - removed the optional property `items/avg_effectiveness` from the response with the `200` status
  - removed the optional property `items/effectiveness_percentile` from the response with the `200` status
- **2026-08-12** `1fe58b98e307` — 1 breaking, 3 info
  - the response property `items/avg_peer_score` became nullable for the status `200`
  - added the new optional `query` request parameter `includeOperatorStubs`
  - added the optional property `items/avg_effectiveness` to the response with the `200` status
  - added the optional property `items/effectiveness_percentile` to the response with the `200` status

[Change history](https://skmtc.dev/obol/apis/obol-api/changes/v1/lock/:lockHash/peer-scores/get.md)

---

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