Skip to main content
Metagraphed
Operations

Schemas & contracts

JSON Schema is canonical truth. Drift compares the current snapshot to the previous published version.

Schemas
15
Stable
14
Drift
1
Subnets covered
13
Contracts

Published contracts

Versioned envelope contracts that govern API responses.

contracts
Public artifact contract metadata for metagraph.sh consumers.
providers
Provider/source registry.
provider-detail
Per-provider detail payload.
provider-endpoints
Endpoint resources for one provider or operator.
api-index
Clean API route index for metagraph.sh consumers.
openapi
OpenAPI 3.1 contract for the metagraph.sh backend API.
type-definitions
Generated TypeScript definitions for metagraph.sh backend consumers.
changelog
Reviewable generated artifact and subnet-change summary.
subnets
All active Finney subnets with compact registry metadata.
metagraph-latest
Latest normalized all-subnet metagraph index with chain-native state and registry coverage metadata.
subnet-detail
Per-subnet detail payload.
subnet-overview
Composed per-subnet overview: profile + health + curation + gaps + counts.
profiles
Public-safe subnet identity and completeness profiles.
profile-detail
Per-subnet public-safe profile detail.
surfaces
Curated public interface surfaces only.
surface-aliases
Deprecated surface display-id aliases mapped to stable surface keys for renamed surfaces.
surfaces-subnet
Curated public interface surfaces for one subnet.
endpoints
Generalized endpoint/resource registry derived from curated surfaces and probe observations.
endpoints-subnet
Generalized endpoint/resource registry for one subnet.
candidates
Unpromoted candidate surfaces from public discovery.
candidates-subnet
Unpromoted candidate surfaces for one subnet.
review-queue
Candidate surfaces queued for maintainer review.
search
Compact search index for subnets, surfaces, and providers.
coverage
Registry coverage counts and source precedence.
coverage-depth
Machine-usable coverage depth scorecard with per-subnet readiness dimensions and a ranked enrichment queue.
economics
Per-subnet validator and economic metrics from the chain: validator/miner counts, total + max stake, registration cost, alpha price, and derived price-weighted emission share.
registry-summary
Registry-wide summary: completeness rollup, top subnets, level counts, latest changes.
lineage
Cross-network subnet lineage: maintainer-approved mainnet ↔ testnet pairs with reviewed match evidence.
fixtures-index
Index of captured live request/response fixtures (which surfaces carry a sanitized sample).
agent-resources
Machine index of every AI resource: the copyable agent, the MCP server + tools, the skill, llms.txt, OpenAPI, and the agent-facing APIs.
fixture-detail
A captured, sanitized live request/response sample for one surface.
curation
Curation state and gaps for every active subnet.
gaps
Missing public interface facets by subnet.
verification
Latest candidate verification snapshot.
verification-subnet
Latest candidate verification snapshot for one subnet.
freshness
Freshness and staleness summary for generated backend data.
source-health
Upstream source and provider health summary.
source-snapshots
Compact hashes and counts for canonical source inputs.
evidence-ledger
Public evidence ledger for subnet and surface claims.
evidence-subnet
Public evidence ledger claims for one subnet.
health-latest
Latest surface health snapshot.
health-summary
Global and per-subnet health rollup.
health-history
Compact daily health-history snapshot.
health-subnet
Per-subnet health payload for metagraph.sh consumers.
health-badge
Badge data contract for status rendering.
health-trends
Computed 7d/30d uptime + latency trends for one subnet's operational surfaces. Served live from D1 at /api/v1/subnets/{netuid}/health/trends (no static file).
health-trends-bulk
Compact all-subnet 7d/30d daily uptime + latency trend matrix. Served live from D1 at /api/v1/health/trends (no static file).
health-percentiles
Latency percentiles (p50/p95/p99 + avg/min/max) per operational surface for one subnet, computed live from D1 at /api/v1/subnets/{netuid}/health/percentiles (no static file).
health-incidents
SLA (uptime ratio) and reconstructed downtime incidents per operational surface for one subnet, computed live from D1 at /api/v1/subnets/{netuid}/health/incidents (no static file).
subnet-trajectory
Week-over-week structural trajectory (completeness + surface/endpoint counts) for one subnet from daily snapshots, served live from D1 at /api/v1/subnets/{netuid}/trajectory (no static file).
subnet-uptime
Long-term daily uptime history per operational surface for one subnet (90d/1y window), served live from the surface_uptime_daily D1 rollup (no static file).
global-incidents
Recent cross-subnet downtime incidents reconstructed from probe history over a 7d or 30d window, served live from D1 at /api/v1/incidents (no static file).
registry-leaderboards
Registry leaderboards (healthiest, fastest-rpc, most-complete, most-enriched, fastest-growing), computed live from D1 + registry projections at /api/v1/registry/leaderboards (no static file).
rpc-usage
RPC reverse-proxy usage analytics (request volume, latency p50/p95, failover + error rate, cache-hit rate, per-endpoint distribution, and bounded time buckets) over a 7d/30d window, computed live from the rpc_proxy_events telemetry at /api/v1/rpc/usage (no static file).
rpc-endpoints
Bittensor base-layer RPC endpoint registry and probe status.
rpc-pools
Endpoint pool scoring for future read-only RPC routing.
endpoint-pools
Generalized endpoint pool scoring for future read-only routing.
endpoint-incidents
Probe-derived endpoint incident summary and active endpoint failures.
operational-surfaces
Operational surfaces (RPC/WSS/subnet-api/SSE/data-artifact) probed live by the cron health prober; input list for the 2-minute scheduled prober.
agent-catalog
Compact index of subnets exposing callable services (subnet-api/openapi/sse/data-artifact) — the machine-readable 'which subnet does X + how to call it' index for AI agents.
agent-catalog-subnet
Per-subnet agent capability catalog: each callable service with its base URL, auth, machine-readable schema, and live-build health/eligibility.
schema-drift
OpenAPI schema snapshot/drift status.
schema-index
Index of captured machine-readable schemas.
schema-snapshot
Captured machine-readable OpenAPI/Swagger schema snapshot detail.
adapter
Adapter-backed public metrics by subnet slug.
r2-manifest
R2 upload manifest for generated artifact history.
review-curation
Maintainer curation and adapter candidate report.
review-gap-priorities
Subnet interface gap priorities.
subnet-gaps
Interface gap priorities and enrichment queue for one subnet.
review-profile-completeness
Profile completeness and contributor targeting report.
review-adapter-candidates
Subnets worth deeper adapter work.
review-enrichment-queue
Prioritized all-subnet enrichment work queue for contributor-safe registry improvements.
review-enrichment-evidence
Detailed candidate evidence by missing or contributor-target surface kind for enrichment work.
review-enrichment-targets
Contributor-oriented enrichment target pack grouped by submission kind, review route, and evidence action.
review-decisions
Public-safe maintainer review decision ledger.
build-summary
Generated build summary.
Explorer

Schema index

Browse every tracked JSON Schema. Select one to inspect the latest snapshot and recent drift.

Snapshot from — may be lagging behind live.