API referenceHealth
Subnet Uptime
Last updated
Fetch long-term daily uptime history per operational surface for one subnet over a 90d or 1y window (computed live from the surface_uptime_daily D1 rollup). Pass min_samples to drop low-sample day rows (daily probe count below the threshold, including zero-sample 'unknown' days) from the history.
Path Parameters
netuid*integer
Range
0 <= valueQuery Parameters
window?string
Value in
- "90d"
- "1y"
min_samples?integer
Range
0 <= valueResponse Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/subnets/0/uptime"{ "data": { "netuid": 7, "reliability": { "avg_latency_ms": 120, "computed_at": "2026-06-01T00:00:00.000Z", "day_count": 1, "grade": "A", "latency_sample_count": 120, "sample_count": 1, "score": 100, "surface_count": 1, "uptime_ratio": 0.9966, "window": "30d" }, "schema_version": 1, "source": "live-cron-prober", "surfaces": [ { "day_count": 1, "days": [ { "day": "2026-06-01", "samples": 1, "status": "ok", "uptime_ratio": 0.9966 } ], "samples": 1, "surface_id": "example", "uptime_ratio": 0.9966 } ], "window": "30d" }, "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}