# Peyon Bittensor Subnet Snapshot

> Peyon Bittensor Subnet Snapshot is a paid API for AI agents from peyon.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29).

Returns a live on-chain snapshot of any Bittensor subnet including alpha price, pool reserves, emission share, consensus mode, validator permits, owner keys, and registration age.

## Facts

- Endpoint: GET https://peyon.ai/api/subnet/:netuid?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/peyon-bittensor-subnet-snapshot-379f8ea2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7ol_TWDf2XiVx-GmrIOYH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability peyon-bittensor-subnet-snapshot-379f8ea2
```

Example prompt: Pull the live on-chain snapshot for Bittensor subnet 18 — I want to see the alpha price in TAO, pool reserves, emission share, and what consensus mode it's running.

## When to prefer this

Use this endpoint when you need a live, single-call on-chain snapshot of a specific Bittensor subnet covering economics, governance, and ownership data together. It is ideal when you need alpha price, pool reserves, emission share, consensus mode, and validator permits in one response rather than querying each from a separate source. Prefer this over block explorers when you need structured, machine-readable output for an agent workflow.

## Known failure modes

- Invalid netuid format (must be 1-3 digit numeric string) returns a 400 error
- Netuid that does not correspond to a registered subnet returns empty or not-found response
- Chain read latency or RPC node unavailability may cause timeout
- Payment failure or insufficient USDC balance returns 402 Payment Required

## How this service works

Live snapshot of any Bittensor subnet read from the chain: alpha price in TAO, pool reserves, alpha outstanding, share of TAO emission, consensus mode (Yuma or Null), validator permits, owner keys, registration age.

## Output

Returns a structured on-chain snapshot for the requested subnet including: alpha token price in TAO, pool reserves (TAO and alpha sides), total alpha outstanding, percentage share of TAO emission, consensus mode (Yuma or Null), list of validator permit holders, owner coldkey address, and subnet registration age.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "netuid"
     ],
     "properties": {
      "netuid": {
       "type": "string",
       "pattern": "^[0-9]{1,3}$"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/peyon-bittensor-subnet-snapshot-379f8ea2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from peyon.ai](https://www.zero.xyz/host/peyon.ai/llms.txt)