latestOpenAPI 3.0.02026-08-138371125.7 KB

707a88e0b355

Cluster Lock

Get cluster network performance percentile

Returns cluster network performance percentile vs sampled baseline (30d cluster avg) from ClickHouse cluster_effectiveness_percentiles. Metrics are null when no snapshot exists.

get/v1/lock/{lockHash}/network-percentile

Path parameters

lockHashstring required

The lock_hash calculated for a cluster lock.

Response

Cluster network performance percentile for the lock

lock_hashstring

avg_effectivenessnumber nullable

30d average cluster effectiveness

effectiveness_percentilenumber nullable

0–100 network percentile vs sampled baseline; higher is better

active_validators_countnumber nullable

datestring nullable

Snapshot date for the percentile row

Example response

{
  "lock_hash": "0xabcdef1234567890abcdef1234567890abcdef12",
  "avg_effectiveness": 0.985,
  "effectiveness_percentile": 72.5,
  "active_validators_count": 4,
  "date": "2026-08-01"
}