Skip to main content
API referenceSubnets

Subnet Overview

Last updated

GET
/api/v1/subnets/{netuid}/overview

Fetch a composed overview (profile + health + curation + gaps + counts) for one subnet.

Path Parameters

netuid*integer
Range0 <= value

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/subnets/0/overview"
{  "data": {    "contract_version": "2026-06-29.1",    "counts": {      "candidates": 1,      "endpoints": 1,      "surfaces": 1    },    "curation": {      "gap_notes": [        "example"      ],      "level": "native",      "review_state": "unreviewed",      "reviewed_at": "2026-06-01T00:00:00.000Z",      "source_count": 1,      "verified_at": "2026-06-01T00:00:00.000Z"    },    "gap_priorities": [      null    ],    "gaps": {      "gap_notes": [        "example"      ],      "missing_kinds": [        "archive"      ],      "supported_kinds": [        "archive"      ]    },    "generated_at": "2026-06-01T00:00:00.000Z",    "health": {      "avg_latency_ms": 120,      "degraded_count": 1,      "failed_count": 1,      "last_checked": "2026-06-01T00:00:00.000Z",      "last_ok": "2026-06-01T00:00:00.000Z",      "netuid": 7,      "observed_by": "2026-06-01T00:00:00.000Z",      "ok_count": 1,      "status": "ok",      "surface_count": 1,      "unknown_count": 1    },    "health_source": "probe-derived",    "name": "Example Subnet",    "netuid": 7,    "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_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,    "slug": "example-subnet",    "status": "ok"  },  "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}