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