Subnets By Network

Network-addressed form of the route above. mainnet/finney return the same data as the unprefixed path; testnet/test return testnet data.

Path Parameters

network*string

Network to address. mainnet and finney are the same network, as are testnet and test.

Value in

"finney"
"mainnet"
"test"
"testnet"

Query Parameters

netuid?integer

Range0 <= value

netuids?string

Match^\d{1,5}(,\d{1,5}){0,127}$

Lengthlength <= 767

coverage_level?string

Value in

"native-only"
"manifested"
"probed"

curation_level?string

Value in

"native"
"candidate-discovered"
"community-seeded"
"machine-verified"
"maintainer-reviewed"
"adapter-backed"

domain?string

Value in

"agents"
"compute"
"data"
"finance"
"inference"
"media"
"prediction"
"privacy"
"robotics"
"science"
"search"
"security"
"storage"
"training"

status?string

Value in

"active"
"inactive"

subnet_type?string

Value in

"root"
"application"

q?string

Lengthlength <= 200

min_block?number

max_block?number

min_candidate_count?number

max_candidate_count?number

min_integration_readiness?number

max_integration_readiness?number

min_mechanism_count?number

max_mechanism_count?number

min_participant_count?number

max_participant_count?number

min_probed_surface_count?number

max_probed_surface_count?number

min_surface_count?number

max_surface_count?number

min_tempo?number

max_tempo?number

fields?string

Match^[A-Za-z_][A-Za-z0-9_]*(,[A-Za-z_][A-Za-z0-9_]*)*$

limit?integer

Range1 <= value <= 1000

cursor?integer

Range0 <= value

sort?string

Field to sort by — the bare field name only (e.g. sort=total_stake_tao). Pair with the separate order parameter to choose direction; a combined field:desc token is NOT supported.

Value in

"block"
"candidate_count"
"coverage_level"
"curation_level"
"integration_readiness"
"mechanism_count"
"name"
"netuid"
"participant_count"
"probed_surface_count"
"status"
"subnet_type"
"surface_count"
"tempo"

order?unknown

Sort direction for sort: asc or desc (default desc). This is a separate parameter from sort — e.g. ?sort=emission_share&order=desc.

Value in

"asc"
"desc"

format?string

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

Value in

"json"
"csv"

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/finney/subnets"

{  "data": {    "contract_version": "2026-06-29.1",    "generated_at": "2026-06-01T00:00:00.000Z",    "network": "finney",    "notes": "Example description.",    "schema_version": 1,    "source": {      "identity_storage": "example",      "kind": "example",      "method": "GET",      "package": "example",      "rpc_family": "example",      "version": "2026-06-29.1"    },    "subnets": [      {        "coverage_level": "native-only",        "curation_level": "native",        "name": "Example Subnet",        "netuid": 7,        "slug": "example-subnet",        "status": "active",        "subnet_type": "root",        "surface_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}

Path Parameters

Query Parameters

Response Body

200application/json

304

400application/json

404application/json

405application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`