Reference

API reference

Public endpoints for subnet telemetry and operator data.

Status

The public API is planned, not shipped. This page outlines what we intend to expose. Endpoints marked (planned) will return 404 today.

Authentication

  • Public telemetry endpoints require no auth.
  • Operator-scoped endpoints require an API token tied to your portal account. Tokens will be issued from /app/account once that surface ships.

Endpoints

Subnet telemetry

GET /api/public/subnet/status

(planned) Returns the current block, tempo position, registered miner count, and registered validator count.

Per-miner

GET /api/public/miners/:hotkey

(planned) Returns a miner's recent scores, query volume, and uptime. No auth — this data is on-chain anyway.

Operator scope

GET /api/operator/me
Authorization: Bearer <token>

(planned) Returns the calling operator's linked hotkeys and aggregate metrics. Requires a valid portal-issued token.

Rate limits

To be defined. Expect generous limits for unauthenticated telemetry and stricter ones for the operator scope.