Chain Weight Setters
Last updated
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
Trailing lookback window the response is computed over, ending at the most recent data point rather than at today. Accepts 7d, 30d. A longer window is not a superset of a shorter one -- rankings and rates are recomputed over the whole window, not summed.
"7d"Value in
- "7d"
- "30d"
Maximum number of rows to return in one page (at most 100). A larger value, or a non-positive one, is rejected with 400 invalid_query -- so a short page means the result set is exhausted, not that the server quietly capped you (#9916). Omitted, the server applies 20.
1 <= value <= 10020Response format override. Use csv to download the route rows as text/csv; json keeps the default response envelope.
"json"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": { "degraded": { "detail": "example", "reason": "example" }, "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", "observed_through": "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}