# Bittensor TAO Token Fundamentals API

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

Returns TAO token macro fundamentals including total issuance, total stake, free float, stake ratio, supply mined percentage, subnet count, burn cost, current block, USD price, and USD-valued stake/issuance from a self-hosted Subtensor lite node.

## Facts

- Endpoint: GET https://api.carbon-cashmere.de/v1/bittensor/tao
- Price: $0.005/call
- Payment: x402
- Status: down
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-carbon-cashmere-de-7d0abe18
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AMD2Pfzxr_S5wQulvAH3f

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

Example prompt: What are the current TAO token fundamentals — total issuance, stake ratio, free float, percent mined, and USD price — sourced from an independent Subtensor node, not the public Finney RPC?

## When to prefer this

Use this endpoint when you need a comprehensive TAO token economics snapshot from an independent node rather than the public Finney RPC — ideal for staking-ratio alerts, macro monitoring dashboards, supply analytics, or any agent task requiring trustworthy, node-sourced Bittensor fundamentals without relying on third-party aggregators.

## Known failure modes

- Subtensor lite node temporarily unavailable — service error or timeout
- Stale data if the lite node falls behind chain head
- No input parameters means no user-level validation errors
- Rate limiting if called excessively
- Price data lag if external price feed is delayed

## How this service works

Professional crypto market intelligence. Real-time prices, signals, and market scoring.

## Output

A JSON object containing TAO macro metrics: total_issuance (raw and USD), total_stake (raw and USD), free_float, stake_ratio, supply_pct_mined, subnet_count, subnet_burn_cost, current block number, and current price_usd — all sourced from a self-operated Subtensor lite node.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "price_usd": 250.6,
  "stake_ratio": 0.67,
  "total_stake": 7285570,
  "subnet_count": 129,
  "total_issuance": 10850643,
  "subnet_burn_cost": 793.11,
  "supply_pct_mined": 0.52
 }
}
```

## More

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