Skip to main content
API referenceChain

Chain Weight Setters

Last updated

GET
/api/v1/chain/weights/setters

Fetch the network-wide weight-setter leaderboard over a 7d or 30d window: the individual validators driving consensus across every subnet ranked by activity, each with its total WeightsSet count (summed across every subnet it operates on), its share of the network total, and its first/last set time. limit caps the returned page (default 20, max 100); distinct_setters always reports the true network-wide total regardless of limit. The network-wide companion to GET /api/v1/subnets/{netuid}/weights/setters. Computed live from the account_events WeightsSet stream; schema-stable empty leaderboard when cold. Pass ?format=csv to download the leaderboard as CSV.

Query Parameters

window?string

Value in

  • "7d"
  • "30d"
limit?integer
Range1 <= value <= 100
format?string

Response format override. Use csv to download the route rows as text/csv; json keeps the default response envelope.

Value in

  • "json"
  • "csv"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/chain/weights/setters"
{  "data": {    "distinct_setters": 2,    "observed_at": "2026-06-01T00:00:00.000Z",    "schema_version": 1,    "setter_count": 2,    "setters": [      {        "first_set_at": "2026-06-01T00:00:00.000Z",        "hotkey": "5G9hfkx9wGB1CLMT9WXkpHSAiYzjZb5o1Boyq4KAdDhjwrc5",        "last_set_at": "2026-06-01T00:00:00.000Z",        "netuid": null,        "share": 0.75,        "uid": 3,        "weight_sets": 30      },      {        "first_set_at": "2026-06-01T00:00:00.000Z",        "hotkey": null,        "last_set_at": "2026-06-01T00:00:00.000Z",        "netuid": 5,        "share": 0.25,        "uid": 8,        "weight_sets": 10      }    ],    "weight_sets": 40,    "window": "7d"  },  "meta": {    "artifact_path": "example",    "cache": "short",    "contract_version": "2026-06-29.1",    "generated_at": "2026-06-01T00:00:00.000Z",    "pagination": {      "collection": "example",      "cursor": 1,      "limit": 1,      "next_cursor": 1,      "order": "asc",      "returned": 1,      "sort": "example",      "total": 1    },    "published_at": "2026-06-01T00:00:00.000Z",    "source": "live-cron-prober",    "stale_contract": {      "built_under": "example",      "live": "example"    }  },  "ok": true,  "schema_version": 1}