API referenceProfiles
Subnet Profile
Last updated
Fetch public-safe profile detail for one subnet.
Path Parameters
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,profile. One of: candidate_surfaces, endpoints, gaps, notes, profile, subnet, 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|endpoints|gaps|notes|profile|subnet|surfaces)(?:,(?:candidate_surfaces|endpoints|gaps|notes|profile|subnet|surfaces))*$Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/subnets/1/profile"{ "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" } ], "contract_version": "2026-06-29.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", "profile": { "candidate_count": 1, "categories": [ "example" ], "completeness": { "confidence": "low", "gap_reasons": [ "example" ], "identity_level": "none", "identity_surface_count": 1, "missing_critical_count": 1, "missing_identity": [ "archive" ], "missing_operational": [ "archive" ], "missing_required": [ "archive" ], "profile_level": "directory-only", "score": 100 }, "completeness_score": 100, "confidence": "low", "curation_level": "native", "derived_categories": [ "example" ], "derived_description": "Example description.", "endpoint_count": 1, "gap_reasons": [ "example" ], "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, "identity_evidence": { "candidate_identity_count": 1, "curated_identity_count": 1, "curated_identity_kinds": [ "archive" ], "live_candidate_identity_kinds": [ "archive" ], "native_contact_present": false, "native_description_present": false, "native_identity_count": 1, "native_identity_kinds": [ "archive" ], "needs_promotion_kinds": [ "archive" ], "stale_candidate_identity_kinds": [ "archive" ], "unverified_candidate_identity_kinds": [ "archive" ] }, "identity_level": "none", "identity_surface_count": 1, "injection_scrubbed": false, "integration_readiness": 1, "interface_count": 1, "lineage": {}, "missing_critical_count": 1, "missing_identity": [ "archive" ], "missing_operational": [ "archive" ], "missing_required": [ "archive" ], "monitored_endpoint_count": 1, "name": "Example Subnet", "native_identity": { "additional": "example", "contact_present": false, "description": "Example description.", "discord": "example", "discord_url": "https://api.metagraph.sh/example", "github_url": "https://api.metagraph.sh/example", "logo_url": "https://api.metagraph.sh/example", "source": "live-cron-prober", "subnet_name": "Example Subnet", "website_url": "https://api.metagraph.sh/example" }, "native_name": "example", "native_name_quality": "chain", "netuid": 7, "operational_interface_count": 1, "operational_interface_kinds": [ "archive" ], "primary_app_surface": { "id": "example", "kind": "archive", "name": "Example Subnet", "provider": "example-provider", "url": "https://api.metagraph.sh/example" }, "primary_links": { "dashboard_url": "https://api.metagraph.sh/example", "docs_url": "https://api.metagraph.sh/example", "source_repo": "https://api.metagraph.sh/example", "website_url": "https://api.metagraph.sh/example" }, "profile_level": "directory-only", "project_name": "example", "provenance": { "curation_level": "native", "identity_source": "live-cron-prober", "interface_source_count": 1, "review_state": "unreviewed", "reviewed_at": "2026-06-01T00:00:00.000Z", "source_urls": [ "https://api.metagraph.sh/example" ] }, "readiness": { "components": {}, "readiness_tier": "buildable", "readiness_version": 1, "score": 100 }, "review_state": "unreviewed", "slug": "example-subnet", "status": "active", "subnet_type": "root", "suggested_submission_kinds": [ "archive" ], "supported_interface_kinds": [ "archive" ], "surface_count": 1, "symbol": "example", "team": "example" }, "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" } ] }, "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}