Skip to main content

SubnetAIQ Python SDK

Bittensor intelligence in one line. Health scores, mineability, risk levels, intel briefs, and more — for all 128 subnets.

Install

pip install subnetaiq

Quick Start

from subnetaiq import SubnetAIQ

# No key needed for free tier (1,000 calls/month)
aiq = SubnetAIQ()

# Get health scores for all subnets
health = aiq.health()

# Check a specific subnet
sn18 = aiq.health(netuid=18)
print(f"SN18: {sn18['verdict']} — score {sn18['health_score']}")

# Which subnets are profitable to mine?
mine = aiq.mineability()

# Is the subnet owner draining value?
drain = aiq.owner_drain(netuid=71)
print(f"SN71 owner: {drain['drain_status']}")

# Get today's intel brief with buy/sell signals
intel = aiq.intel()

# Current TAO price
price = aiq.tao_price()

With API Key (higher limits)

# Register for a free key
key = SubnetAIQ.register("you@example.com")
print(f"Your key: {key}")

# Use the key
aiq = SubnetAIQ(api_key=key)

# Check your usage
usage = aiq.usage()
print(f"Used {usage['calls_used']}/{usage['limit']} calls this month")

All Methods

Method Description
health(netuid=None) 7-factor health scores, verdict, red flags
emission_share(netuid=None) % of network emissions per subnet
mineability(netuid=None) MINE/CAUTION/AVOID verdicts
risk(netuid=None) Dump/dereg risk: LOW/MODERATE/HIGH/CRITICAL
rankings() Blended ranking with BUY/SELL/HOLD signals
intel() Daily AI-analyzed intelligence brief
live(netuid=None) Real-time price, liquidity, emissions
tao_price() Current TAO/USD price
validators() Validator rankings and take rates
owner_drain(netuid) Owner wallet behavior analysis
usage() Check your API key usage
register(email) Get a free API key

Pricing

  • Free: 1,000 calls/month, 10/min
  • Builder: $29/mo — 25,000 calls/month
  • Pro: $99/mo — 100,000 calls/month
  • Enterprise: $299/mo — 500,000 calls/month

Full API docs →

Links

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

subnetaiq-1.0.0.tar.gz (4.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

subnetaiq-1.0.0-py3-none-any.whl (4.5 kB view details)

Uploaded Python 3

File details

Details for the file subnetaiq-1.0.0.tar.gz.

File metadata

  • Download URL: subnetaiq-1.0.0.tar.gz
  • Upload date:
  • Size: 4.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.3

File hashes

Hashes for subnetaiq-1.0.0.tar.gz
Algorithm Hash digest
SHA256 f226f178752c1b74cebc65fd9d699a27c02c987b7015dc5675de0655677f4b12
MD5 f33ff45a9b68ba855e38f87f49f947f4
BLAKE2b-256 54340402ce406e4fe38ec991135994b75133f2a5179f8ebcc3fb335ce4bf70bb

See more details on using hashes here.

File details

Details for the file subnetaiq-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: subnetaiq-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 4.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.3

File hashes

Hashes for subnetaiq-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bbd2c33118db20efc0f8c516b34df1dec3ad84e5d6de25ef449bdd0611f03803
MD5 391b7f5bc3bf750bb8ddd25568f7337d
BLAKE2b-256 986d7577c4b6bf115fc8ac1099ed9e5180ce5a1fcf2c3723f13d753528d34d5a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page