Bittensor SDK

Query the Bittensor decentralized AI network with structured JSON output.

SDK Scripts

Run scripts with Python (assumes bittensor installed):

# Top validators on a subnet
python scripts/metagraph.py --netuid 8 --top 5

# List all subnets  
python scripts/subnets.py

# Specify network
python scripts/metagraph.py --netuid 1 --network test

Available Scripts

Script	Purpose	Args
metagraph.py	Subnet validators sorted by emission	--netuid, --top, --network
subnets.py	List all subnets	--network

Output Format

All scripts return JSON:

{
  "netuid": 8,
  "name": "Vanta",
  "n_neurons": 256,
  "top_validators": [
    {"rank": 1, "name": "τaoshi validator", "emission": 147.67, "stake": 11859.70}
  ]
}

Common Queries

"Who are the top validators on subnet X?"

python scripts/metagraph.py --netuid X --top 10

"List all subnets"

python scripts/subnets.py

"What's the emission on SN8?" Run metagraph.py and sum the emissions from top_validators.

CLI Fallback

For queries without SDK scripts, use btcli:

btcli wallet balance --wallet.name default
btcli stake list --wallet.name default
btcli subnets register --netuid 8 --wallet.name default

Networks

• finney — Mainnet (default)
• test — Testnet