# Carbon Cashmere Bittensor Subnet Metagraph API

> Carbon Cashmere Bittensor Subnet Metagraph API is a paid API for AI agents from api.carbon-cashmere.de, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns a full metagraph snapshot for a specified Bittensor subnet, including 28 summary fields and per-neuron data for up to 256 miners covering stake, trust, incentive, emission, consensus, dividends, and validator permits.

## Facts

- Endpoint: GET https://api.carbon-cashmere.de/v1/bittensor/:netuid
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-carbon-cashmere-de-0c9c6b43
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WQCeNQ31RNac7n-MPjToH

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 api-carbon-cashmere-de-0c9c6b43
```

Example prompt: Pull the full metagraph snapshot for Bittensor subnet 18 — I want to see the gini coefficient, top-5 stake share, validator dominance, and per-neuron emissions, trust, and incentive scores for all miners.

## When to prefer this

Use this endpoint when you need a comprehensive, live snapshot of a Bittensor subnet's metagraph including all per-neuron analytics. Prefer this over on-chain direct queries when you need pre-computed summary statistics (gini, top5 share, validator dominance) alongside raw neuron data in one call. Ideal for AI agents performing subnet analysis, miner ranking, or validator monitoring without running their own Subtensor node.

## Known failure modes

- Invalid or out-of-range netuid (0-511) returns an error
- Unknown subnet alias returns an error
- Subtensor lite node temporarily unavailable causes timeout or 503
- Payment not completed (x402) causes 402 response blocking access
- netuid parameter missing returns validation error

## How this service works

Get full Bittensor subnet metagraph snapshot — 28 summary fields (block, gini, top5 share, emissions, validator dominance) plus per-neuron array of up to 256 miners with stake, trust, incentive, emission, consensus, dividends, validator_permit, alpha_stake, tao_stake. Accepts integer netuid or named aliases (mantis, sn123). Live from our own Subtensor lite node. AI agent API for subnet analysis, miner performance tracking, validator-weight mapping, and decentralized-AI network intelligence.

## Output

A JSON object with a timestamp, netuid, a summary object containing 28 fields (block, gini, top5 share, emissions, validator dominance, etc.), and a neurons array of up to 256 entries each with uid, stake, trust, active, emission, consensus, dividends, incentive, tao_stake, alpha_stake, last_update, blocks_behind, validator_trust, and validator_permit.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "netuid": 18
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-carbon-cashmere-de-0c9c6b43/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.carbon-cashmere.de](https://www.zero.xyz/host/api.carbon-cashmere.de/llms.txt)
