API referenceSubnets
Subnet Detail By Network
Last updated
Network-scoped form of /api/v1/subnets/{netuid} — prefix the route with a network to choose which chain answers it. 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"
netuid*integer
The subnet's numeric id on the Bittensor network, as used by the chain itself.
Range
0 <= valueQuery Parameters
sections?string
Comma-separated top-level sections to return, e.g. subnet,economics. One of: candidate_surfaces, candidates, economics, endpoints, gaps, notes, subnet, surfaces, verified_surfaces. Selecting sections never removes the response envelope (schema_version, contract_version, generated_at, operational_observed_at, health_source) -- a smaller document still has to say what it is. An unknown name is rejected rather than ignored. A projected document omits every non-selected section, including ones the document schema marks required: required describes the unprojected response (#10960), so a client validating responses should skip validation or treat sections as optional when it sends this parameter. NOT the same parameter as fields, which projects columns out of the rows of a list.
Match
^(?:candidate_surfaces|candidates|economics|endpoints|gaps|notes|subnet|surfaces|verified_surfaces)(?:,(?:candidate_surfaces|candidates|economics|endpoints|gaps|notes|subnet|surfaces|verified_surfaces))*$Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/finney/subnets/1"{ "data": { "candidate_surfaces": [ { "auth_required": true, "id": "example", "kind": "archive", "name": "Example Subnet", "netuid": 7, "provider": "example-provider", "public_safe": true, "schema_version": 1, "source_url": "https://api.metagraph.sh/example", "state": "schema-invalid", "url": "https://api.metagraph.sh/example" } ], "candidates": [ { "auth_required": true, "id": "example", "kind": "archive", "name": "Example Subnet", "netuid": 7, "provider": "example-provider", "public_safe": true, "schema_version": 1, "source_url": "https://api.metagraph.sh/example", "state": "schema-invalid", "url": "https://api.metagraph.sh/example" } ], "contract_version": "2026-06-29.1", "economics": { "alpha_fdv_tao": 0.5, "alpha_fdv_usd": 0.5, "alpha_in_emission": 0.5, "alpha_in_pool": 0.5, "alpha_market_cap_basis": "total_stake_alpha", "alpha_market_cap_tao": 0.5, "alpha_market_cap_usd": 0.5, "alpha_out_emission": 0.5, "alpha_out_pool": 0.5, "alpha_price_change_1d": 0.5, "alpha_price_change_1h": 0.5, "alpha_price_change_1m": 0.5, "alpha_price_change_7d": 0.5, "alpha_price_tao": 0.5, "alpha_price_usd": 0.5, "block": 5000000, "emission_enabled": false, "emission_share": 0.5, "excess_tao": 0.5, "first_emission_block": 5000000, "max_stake_alpha": 0.5, "max_uids": 1, "max_validators": 1, "miner_burned_fraction": 0.5, "miner_count": 1, "miner_readiness": 1, "moving_price_pinned": 0.5, "name": "Example Subnet", "netuid": 7, "open_slots": 1, "owner_coldkey": "example", "owner_hotkey": "example", "registered_at_block": 5000000, "registration_allowed": false, "registration_allowed_pinned": false, "registration_cost_tao": 0.5, "slug": "example-subnet", "spot_price_tao": 0.5, "subnet_mechanism": 1, "subnet_volume_tao": 0.5, "subtoken_enabled": false, "tao_in_emission_tao": 0.5, "tao_in_pool_tao": 0.5, "total_stake_alpha": 0.5, "validator_count": 1 }, "endpoints": [ { "auth_required": true, "health_source": "probe-derived", "health_stale": false, "id": "example", "kind": "archive", "last_ok": "2026-06-01T00:00:00.000Z", "layer": "bittensor-base", "monitoring_policy": { "enabled": true, "expect": "example", "method": "GET", "source": "live-cron-prober" }, "monitoring_status": "monitored", "netuid": 7, "observed_at": "2026-06-01T00:00:00.000Z", "operator": "example-provider", "pool_eligible": false, "provider": "example-provider", "public_safe": true, "publication_state": "candidate", "score": 100, "status": "ok", "surface_id": "example", "surface_key": "example", "url": "https://api.metagraph.sh/example" } ], "gaps": { "gap_notes": [ "example" ], "missing_kinds": [ "archive" ], "moving_target_surfaces": [ "example" ], "supported_kinds": [ "archive" ] }, "generated_at": "2026-06-01T00:00:00.000Z", "health_source": "probe-derived", "notes": "Example description.", "operational_observed_at": "2026-06-01T00:00:00.000Z", "schema_version": 1, "subnet": { "block": 5000000, "candidate_count": 1, "categories": [ "example" ], "contact": "example", "coverage_level": "native-only", "curation": { "level": "native", "review_state": "unreviewed" }, "curation_level": "native", "dashboard_url": "https://api.metagraph.sh/example", "derived_categories": [ "example" ], "description": "Example description.", "docs_url": "https://api.metagraph.sh/example", "gap_count": 1, "gaps": { "gap_notes": [ "example" ], "missing_kinds": [ "archive" ], "supported_kinds": [ "archive" ] }, "github_commits_weekly": [ { "count": 1, "week": "2026-06-01T00:00:00.000Z" } ], "github_languages": {}, "github_last_push_at": "2026-06-01T00:00:00.000Z", "github_releases": [ { "name": "Example Subnet", "prerelease": false, "published_at": "2026-06-01T00:00:00.000Z", "tag": "example", "url": "https://api.metagraph.sh/example" } ], "github_stars": 1, "github_unreachable": false, "lifecycle": "active", "links": [ { "label": "example", "url": "https://api.metagraph.sh/example" } ], "logo_url": "https://api.metagraph.sh/example", "mechanism_count": 1, "name": "Example Subnet", "native_name": "example", "native_name_quality": "chain", "native_slug": "example-subnet", "netuid": 7, "notes": "Example description.", "participant_count": 1, "partnership": { "since": "2026-06-01", "tier": "pilot" }, "previously_known_as": [ "example" ], "probed_surface_count": 1, "provenance": {}, "registered_at_block": 5000000, "revenue_search": { "checked": [ "website" ], "outcome": "none-found", "searched_at": "2026-06-01T00:00:00.000Z" }, "slug": "example-subnet", "social": {}, "source_repo": "https://api.metagraph.sh/example", "status": "active", "subnet_type": "root", "surface_count": 1, "symbol": "example", "tempo": 1, "wallet_search": { "checked": [ "website" ], "outcome": "none-found", "searched_at": "2026-06-01T00:00:00.000Z" }, "website_url": "https://api.metagraph.sh/example" }, "surfaces": [ { "auth_required": true, "authority": "community", "id": "example", "kind": "archive", "netuid": 7, "provider": "example-provider", "public_safe": true, "url": "https://api.metagraph.sh/example" } ], "verified_surfaces": [ { "auth_required": true, "authority": "community", "id": "example", "kind": "archive", "netuid": 7, "provider": "example-provider", "public_safe": true, "url": "https://api.metagraph.sh/example" } ] }, "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}