# Bittensor Network Fundamentals API

> Bittensor Network Fundamentals API is a paid API for AI agents from api.carbon-cashmere.de, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns real-time TAO network-wide macro metrics including total issuance, total stake, free float, supply percentage mined, and stake ratio from a live Subtensor node snapshot updated every 10 minutes.

## Facts

- Endpoint: GET https://api.carbon-cashmere.de/v1/bittensor-derivatives/network-fundamentals
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-carbon-cashmere-de-a37a63ff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GUhkJoRUl2LcvFX-myF1w

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-a37a63ff
```

Example prompt: What are the current Bittensor network fundamentals — total TAO issuance, total stake, free float, and what percentage of supply has been mined so far?

## When to prefer this

Use this endpoint when you need a quick macro-level overview of the Bittensor/TAO network — total supply dynamics, staking participation, and circulating float — without needing per-subnet or per-neuron granularity. Prefer this over the metagraph endpoint when the question is about the whole network rather than a specific subnet.

## Known failure modes

- Subtensor node temporarily unavailable — snapshot data may be stale or endpoint returns 503
- Rate limiting or payment failure via x402 protocol — returns 402 or 429
- Snapshot older than 10 minutes if node sync lag occurs — data may not reflect very latest block

## How this service works

Latest TAO network-wide fundamentals: total issuance, total stake, free float, supply percentage mined, stake ratio. Snapshot every 10 min.

## Output

A JSON object containing TAO network-wide macro data: total issuance (total TAO created), total stake (TAO locked in staking), free float (circulating unstaked TAO), supply percentage mined (fraction of max supply emitted), and stake ratio (proportion of supply staked). Data is sourced from a Subtensor node snapshot refreshed every 10 minutes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ts": "...",
  "stake_ratio": 0.668,
  "total_subnets": 129,
  "total_stake_tao": 10911029,
  "supply_pct_mined": 0.3473,
  "total_issuance_tao": 7294562
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-carbon-cashmere-de-a37a63ff/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)