TAOSCOPE / Reference

Explorer API

A versioned server-to-server API for TaoScope's indexed Bittensor explorer data. Create a key in your profile and send it with every request.

Authentication

Create an API key from /profile. TaoScope shows the full secret once and stores only its SHA-256 hash. Send the secret as a bearer token or in the X-API-Key header.

Treat API keys like passwords

Do not put an API key in browser JavaScript, a public repository, analytics events, or client-visible environment variables. Use it from your server.

Endpoints

  • GET /api/v1/explorer/overview — network statistics, leading subnets, and emission allocation.
  • GET /api/v1/explorer/subnets — subnet list with status, sorting, and optional limits.
  • GET /api/v1/explorer/subnets/:id — one subnet and its validator context.
  • GET /api/v1/explorer/subnets/:id/history — 7-day or 30-day price history. Pro plan.
  • GET /api/v1/explorer/validators — validator list with status, permit, subnet, sorting, and limits.
  • GET /api/v1/explorer/validators/:hotkey — validator details and observed history.
  • GET /api/v1/explorer/transactions — indexed network transactions with pagination.
  • GET /api/v1/explorer/transactions/:id — one indexed transaction.

Filtering and limits

Subnets

Use status, sort, order, and limit. Sort fields are explicitly allow-listed; unsupported field names fall back to the endpoint default rather than accessing arbitrary object properties.

Validators

Use status, permit, subnet, sort, order, and limit.

Transactions

Use netuid, action, delegateHotkey, page, and limit. Transaction page size is capped at 200.

Quotas

The response includes minute and monthly quota headers. Usage is incremented atomically so concurrent requests cannot bypass a plan limit. Current plan limits are shown on the pricing and profile pages.

Errors

  • 400 — an identifier or query value is invalid.
  • 401 — the API key is missing, invalid, or revoked.
  • 403 — the endpoint requires a higher plan.
  • 404 — the requested subnet, validator, or transaction does not exist.
  • 429 — the minute or monthly plan quota has been reached.
  • 503 — prepared explorer data is temporarily unavailable.

Last updated September 1, 2026