# Bittensor Subnet Metagraph Slice

> Bittensor Subnet Metagraph Slice is a paid API for AI agents from api.chainmarket-api.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-02).

Returns a paginated slice of the full Bittensor subnet metagraph, including neuron metadata such as uid, hotkey, coldkey, stake, rank, trust, consensus, incentive, dividends, and emission for a given subnet.

## Facts

- Endpoint: GET https://api.chainmarket-api.workers.dev/api/crypto/tao-subnet-metagraph?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bittensor-subnet-metagraph-slice-d24c55ea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IQlOB0bkerb-D_fVQLk38

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 bittensor-subnet-metagraph-slice-d24c55ea
```

Example prompt: Pull the first 50 neurons from Bittensor subnet 18 — I want to see their hotkeys, coldkeys, alpha stake, rank, trust, consensus, incentive, dividends, and emission.

## When to prefer this

Choose this endpoint when you need structured, paginated access to Bittensor subnet metagraph data including validator and neuron attributes like stake, rank, trust, consensus, incentive, dividends, and emission. Prefer it over raw on-chain queries when you want pre-processed, human-readable neuron records without running a full Subtensor node.

## Known failure modes

- Missing or invalid TAOSTATS_API_KEY returns 401 Unauthorized
- Invalid or non-existent netuid returns empty results or 404
- limit out of range (below 1 or above 100) returns a validation error
- offset beyond total neuron count returns an empty array
- Network or upstream TaoStats API outage returns 500 or timeout

## How this service works

Full Bittensor subnet metagraph slice with pagination (limit 1-100, page/offset): uid, hotkey, coldkey, name, total alpha stake, alpha stake, validator permit, rank, trust, consensus, incentive, dividends, and emission. Requires TAOSTATS_API_KEY.

## Output

Returns a paginated array of neuron records for the specified subnet, each containing: uid, hotkey address, coldkey address, name, total alpha stake, alpha stake, validator permit flag, rank, trust, consensus, incentive, dividends, and emission values. Pagination metadata (total count, current offset, limit) is typically included.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1,
       "description": "Number of neurons per page (1-100, default 50)"
      },
      "netuid": {
       "type": "integer",
       "minimum": 0,
       "description": "Subnet network UID (default 1)"
      },
      "offset": {
       "type": "integer",
       "minimum": 0,
       "description": "Pagination offset (default 0)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bittensor-subnet-metagraph-slice-d24c55ea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.chainmarket-api.workers.dev](https://www.zero.xyz/host/api.chainmarket-api.workers.dev/llms.txt)