Chain Subnet Lifecycle
Last updated
Fetch every subnet's registrations and deregistrations across the network (#10263), newest first, from the subnet_lifecycle Neon table. ?window=7d|30d|90d|1y|all (default all — a subnet changes state a handful of times in its lifetime, so a short window is almost always empty). ?limit (<=1000). Pass ?format=csv to download the page 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, 90d, 1y, all. A longer window is not a superset of a shorter one -- rankings and rates are recomputed over the whole window, not summed.
"all"Value in
- "7d"
- "30d"
- "90d"
- "1y"
- "all"
Maximum number of rows to return in one page (at most 1000). 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 50.
1 <= value <= 100050Response 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/subnet-lifecycle"{ "data": { "entries": [ { "block_number": 5000000, "event": "registered", "netuid": 7, "observed_at": "2026-06-01T00:00:00.000Z", "predates_capture": false } ], "entry_count": 1, "limit": 1, "next_cursor": "example", "offset": 1, "schema_version": 1, "subnet_count": 1 }, "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}