# Bittensor Subnet Leaderboard API

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

Ranks Bittensor subnets by configurable network metrics (alpha_price_tao, total_stake, gini_stake, n_active, etc.) from a live Subtensor lite node

## Facts

- Endpoint: GET https://api.carbon-cashmere.de/v1/bittensor/network/subnet-leaderboard
- Price: $0.05/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-e60b00ce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JITwewI3fsFuVvNoYKe9D

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

Example prompt: Show me the top 10 Bittensor subnets ranked by total_stake in descending order — I want to see which subnets are dominating right now.

## When to prefer this

Use this endpoint when you need a ranked comparison of Bittensor subnets across network-level metrics such as stake, price, activity, or decentralization. Prefer this over raw metagraph endpoints when you want aggregate subnet-level scoring rather than per-miner or per-neuron data. Ideal for dashboards, subnet discovery, and investment or delegation research on the Bittensor network.

## Known failure modes

- Invalid metric name returns an error or empty results
- Limit exceeding supported range may return a 400 or truncated response
- Subtensor lite node downtime may cause 503 or stale data
- Missing required metric parameter may return a 400 bad request
- Network congestion on Bittensor may cause delayed or inconsistent data

## How this service works

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

## Output

An ordered leaderboard of Bittensor subnets ranked by the chosen metric (e.g. alpha_price_tao, total_stake, gini_stake, n_active), with network-aggregate statistics sourced from a live Subtensor lite node. No per-miner data is included — results are subnet-level summaries only.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "order": "desc",
  "metric": "alpha_price_tao",
  "ranking": [
   {
    "rank": 1,
    "netuid": 64,
    "n_neurons": 256,
    "gini_stake": 0.99,
    "alpha_price_tao": 0.074613,
    "n_active_neurons": 12
   },
   {
    "rank": 2,
    "netuid": 8,
    "n_neurons": 256,
    "gini_stake": 0.95,
    "alpha_price_tao": 0.05214,
    "n_active_neurons": 18
   }
  ],
  "subnets_returned": 10
 }
}
```

## More

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